Iterant is in early access. These docs describe the product as it works today.
Iterant Docs
tasks

Start an agent task

Run one autonomous agent turn for this brand. `command: "prompt"` takes a free-form `prompt`, the instruction the agent carries out ("Add an About page with a team section"). `command: "build_page"` takes an `opportunityRef` from the page-opportunities list and builds that page. A task takes about five minutes. Poll the task detail route every 30-60 seconds, or watch the chat thread the response links to. **One task at a time per brand.** A second create while one is running answers 409: the agent holds a single workspace per brand, so it runs tasks one after another rather than queuing them. Wait for the running task to settle, then submit the next one.

POST
/api/v1/public/brands/{brandSlug}/tasks/

Authorization

tenantApiKeyAuth
AuthorizationBearer <token>

In: header

Path Parameters

brandSlug*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/public/brands/string/tasks/" \  -H "Content-Type: application/json" \  -d '{    "command": "prompt",    "prompt": "Add an About page with a team section."  }'
{  "taskId": "6f1d8a52-0b3e-4f7a-9c2d-5a1b7e4c8d90",  "command": "prompt",  "status": "running",  "chatUrl": "https://app.iterant.ai/orbital-labs/chat?chat=6f1d8a52-0b3e-4f7a-9c2d-5a1b7e4c8d90",  "createdAt": "2026-07-26T09:14:03.221Z"}

Last updated on

List agent tasks

Tasks this brand has run, newest first. A `build_page` task reports the state of the page build it wraps, so its `status` is always what the opportunity itself says. A task that has been running for more than two hours with no word from the agent is reported as `failed`.

Get an agent task

Poll this every 30-60 seconds while a task runs; a typical task settles in about five minutes. `resultingRoute` is the page a `build_page` task produced. It is always empty for a `prompt` task, even on success: a free-form turn has no single route, and its result is the chat thread at `chatUrl`. `error` is present only when `status` is `failed`.