Skip to main content
POST
Create a Super Agent async run

Authorizations

Authorization
string
header
default:cr_sk_your_key_here
required

Account API key from Developer Console. Keys start with cr_sk_.

Body

application/json
input
any
required

JSON input for Super Agent. Serialized input must be 256 KB or smaller.

model
string

Model id to run with (for example, anthropic/claude-haiku-4-5). Omit to use the default model, currently anthropic/claude-sonnet-5. Supported ids: GET /v1/models.

Maximum string length: 100
conversation_id
string<uuid>

Existing Super Agent conversation to continue. Agent Run conversations are rejected.

workspace_id
string<uuid>

Personal workspace whose root uploads Super Agent can read.

webhook_url
string<uri>

Public http or https URL for the terminal async result.

Maximum string length: 2048
should_notify
boolean

Optional boolean gate for completion notifications. Not accepted on realtime runs.

Response

Run accepted.

run_id
string<uuid>
required

Developer API run ID.

status
enum<string>
required
Available options:
pending,
running,
completed,
failed,
cancelled
agent_id
string<uuid> | null
required

Agent that ran. Creation runs return null until the agent is created, then the completed run includes the new agent ID.

conversation_id
string<uuid> | null
required

Conversation ID for follow-up runs.

model
string | null
required

Model id this run executed with. null only for runs created before model selection shipped.

workspace_id
string<uuid> | null

Personal workspace bound to this conversation, when set.

result
object

Final agent output. Completed runs commonly include text; agent-creation runs also include agent_id.

usage
object
error
object
created_at
string<date-time>
started_at
string<date-time> | null
completed_at
string<date-time> | null
webhook_delivered_at
string<date-time> | null