Get a build conversation

curl --request GET \
  --url https://{subdomain}.mihu.ai/api/v1/builder-agents/{uuid} \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "message": "Build conversation retrieved successfully",
  "data": {
    "uuid": "a1b2c3d4-0000-4000-8000-000000000001",
    "name": "zoho-lead-watcher",
    "status": "gathering",
    "prompt": "Watch my Zoho CRM leads every 5 minutes",
    "message": "A couple of things before I build this:",
    "questions": [
      "Use your stored Zoho credentials, or paste new ones?",
      "Which region should I poll — EU or US?"
    ],
    "builder": null,
    "created_at": "2026-06-13T08:00:00Z"
  }
}

Builders

Get a build conversation

The polling endpoint that drives the whole conversation. Call it repeatedly (~every 2-3 seconds) after starting a conversation or sending an answer.

Read status to decide what to do next:

processing — the builder is still working. Keep polling, do nothing else.
gathering — it needs input. Show message and questions to the user, then POST to /answers.
deployed — done. The builder field holds the running app (with preview_url). Stop polling.
failed — done unsuccessfully. Stop polling; start a new conversation with a revised prompt.

GET

api

builder-agents

{uuid}

Get a build conversation

curl --request GET \
  --url https://{subdomain}.mihu.ai/api/v1/builder-agents/{uuid} \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "message": "Build conversation retrieved successfully",
  "data": {
    "uuid": "a1b2c3d4-0000-4000-8000-000000000001",
    "name": "zoho-lead-watcher",
    "status": "gathering",
    "prompt": "Watch my Zoho CRM leads every 5 minutes",
    "message": "A couple of things before I build this:",
    "questions": [
      "Use your stored Zoho credentials, or paste new ones?",
      "Which region should I poll — EU or US?"
    ],
    "builder": null,
    "created_at": "2026-06-13T08:00:00Z"
  }
}

Authorizations

Authorization

string

header

required

Use a Bearer token to access these API endpoints. Example: "Bearer {your-token}"

Path Parameters

uuid

string<uuid>

required

Response

The build conversation in its current state.

success

boolean

Example:

true

data

object

An AI build conversation. While requirements are missing it stays 'processing' then 'gathering' (with questions); once answered it generates code and the status becomes 'deployed' (with a builder) or 'failed'.

Show child attributes

Start a build conversation Delete a build conversation