Start a build conversation

curl --request POST \
  --url https://{subdomain}.mihu.ai/api/v1/builder-agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Watch my CRM for new leads every 5 minutes and expose them",
  "name": "<string>",
  "auto_approve": false,
  "skip_qa": false
}
'

{
  "success": true,
  "data": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "lead-watcher",
    "prompt": "<string>",
    "message": "<string>",
    "questions": [
      "<string>"
    ],
    "builder": {
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "lead-watcher",
      "preview_url": "<string>",
      "service_token": "<string>",
      "entrypoint": "python3 main.py",
      "port": 8000,
      "auto_stop_interval": 0,
      "backup_interval_hours": 0,
      "review_passed": true,
      "qa_passed": true,
      "cost": {
        "currency": "EUR",
        "hourly_rate": 0.1965,
        "runtime_hours": 1.5,
        "cost": 0.29
      },
      "created_at": "2023-11-07T05:31:56Z"
    },
    "created_at": "2023-11-07T05:31:56Z"
  }
}

Builders

Start a build conversation

Describe what you want in one sentence and the AI builder takes it from there. This is the entry point of an asynchronous, multi-turn conversation.

How it works (the full loop):

POST /api/v1/builder-agents with your prompt. It returns immediately with status: processing and a uuid — the build does not run inline (that would exceed request timeouts), it runs in the background.
Poll GET /api/v1/builder-agents/{uuid} every ~2-3 seconds. While the builder is thinking it stays processing; keep polling.
When it needs input the status becomes gathering: read message (what it’s asking) and questions (the list to answer). Typical questions: which credentials to use, region/fields, VM size, one-time vs always-on, backup frequency.
Reply with POST /api/v1/builder-agents/{uuid}/answers (a single message). That call also returns processing — poll again (step 2). The loop repeats until the builder has everything.
The conversation ends in one of two terminal states:
- deployed — the app was generated and is running. The builder field holds the live builder (with preview_url). Operate it via the /api/v1/builders endpoints.
- failed — generation could not complete. Start a new conversation with an adjusted prompt.

When it ‘works’: a simple agent is usually deployed after 1-2 question rounds; each round is a few seconds of processing, plus ~1 minute for the final deploy. There is no fixed limit on rounds — keep answering until terminal.

Example: prompt ‘Watch my Zoho CRM leads every 5 minutes’ → processing → gathering (‘Use stored Zoho credentials or paste new ones? Which region?’) → answer → processing → deployed with a preview URL.

POST

api

builder-agents

Start a build conversation

curl --request POST \
  --url https://{subdomain}.mihu.ai/api/v1/builder-agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Watch my CRM for new leads every 5 minutes and expose them",
  "name": "<string>",
  "auto_approve": false,
  "skip_qa": false
}
'

{
  "success": true,
  "data": {
    "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "lead-watcher",
    "prompt": "<string>",
    "message": "<string>",
    "questions": [
      "<string>"
    ],
    "builder": {
      "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "lead-watcher",
      "preview_url": "<string>",
      "service_token": "<string>",
      "entrypoint": "python3 main.py",
      "port": 8000,
      "auto_stop_interval": 0,
      "backup_interval_hours": 0,
      "review_passed": true,
      "qa_passed": true,
      "cost": {
        "currency": "EUR",
        "hourly_rate": 0.1965,
        "runtime_hours": 1.5,
        "cost": 0.29
      },
      "created_at": "2023-11-07T05:31:56Z"
    },
    "created_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

Authorization

string

header

required

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

Body

application/json

prompt

string

required

Example:

"Watch my CRM for new leads every 5 minutes and expose them"

name

string | null

Optional name. Auto-derived from the prompt if omitted.

auto_approve

boolean

Skip the one-time approval gate and build immediately (for automation).

Example:

false

skip_qa

boolean

Deploy without the pre-deploy review and post-deploy QA (faster, unverified). Self-heal still runs.

Example:

false

Response

Conversation started.

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

List build conversations Get a build conversation