Agent Builder

Start an Agent Builder session

Session Lifecycle

POST /start (this endpoint) — create a session from a prompt → returns sessionId.
GET //status — poll every few seconds until status is "completed" (the AI finished building the agent successfully), "ready" (the AI finished its turn but the agent may not have been saved yet), or "error". On any terminal status the response also contains agentId and agentName; stop polling at that point. Subsequent calls may return the same terminal response or 404 — both mean the build is done.
POST //stop (optional) — abort the session early if you no longer want the build to continue. Returns 204 No Content. Has no effect once the session has already reached a terminal state.

Note: The session tears down automatically a short time after reaching a terminal status — no explicit teardown call is required. The agent draft is saved in your workspace as soon as the AI creates it (before the session ends). The draft persists whether or not you call /stop; use the standard agents API to delete unwanted drafts.

POST

api

agent-builder

start

cURL

curl https://dashboard.sequentum.com/api/v1/agent-builder/start \
  -H "Authorization: ApiKey $SEQUENTUM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Build an agent that extracts product names and prices from example.com.",
    "spaceId": 42
  }'

{
  "sessionId": "<string>"
}

Authorizations

Authorization

string

header

required

API Key authorization header. Example: "Authorization: ApiKey {your-api-key}"

Authorization

string

header

required

OAuth 2.0 Bearer token. Example: "Authorization: Bearer {access-token}"

Body

application/json

The prompt and optional space to save to

Request to start an agent building session via the external API.

prompt

string

required

Natural language prompt describing the automation to build. Must be between 10 and 5000 characters (trimmed).

Required string length: 10 - 5000

spaceId

integer<int32> | null

Optional space ID to save the agent to. Uses the default space if omitted.

Response

Response when starting an agent build session via the external API.

sessionId

string

required

Session ID to use for status polling and subsequent calls.

Minimum string length: 1

Errors Get session status