Create an async run

curl --request POST \ --url https://developer.creao.ai/v1/runs \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "agent_id": "00000000-0000-4000-8000-000000000000", "input": { "company": "Apple", "year": "2025" } } '

{ "run_id": "11111111-1111-4111-8111-111111111111", "status": "pending", "agent_id": "00000000-0000-4000-8000-000000000000", "conversation_id": "22222222-2222-4222-8222-222222222222", "model": "anthropic/claude-haiku-4-5" }

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

agent_id

string<uuid>

required

Active personal CREAO agent to run.

input

any

required

JSON input for the 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. Unknown ids return 400 MODEL_NOT_SUPPORTED; models not available on your plan return 403 MODEL_NOT_ALLOWED.

Maximum string length: 100

conversation_id

string<uuid>

Existing conversation to continue. Omit to create a new conversation.

workspace_id

string<uuid>

Personal workspace whose root uploads the agent can read. On a new conversation this value is stored. On an existing conversation it must match the bound workspace or the conversation must be unbound. Mismatch returns 409 WORKSPACE_MISMATCH. Not accepted on agent create or edit runs.

webhook_url

string<uri>

Public http or https URL for the terminal async result.

Maximum string length: 2048

should_notify

boolean

Optional. Controls whether this run should be eligible for completion notifications.

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.

Show child attributes

usage

object

Show child attributes

error

object

Show child attributes

created_at

string<date-time>

started_at

string<date-time> | null

completed_at

string<date-time> | null

webhook_delivered_at

string<date-time> | null

Get Started

Agents

Agent Memory

Agent Files

Runs

Models

Workspaces

Workspace Files

Secrets

Skills

Concepts

Authorizations

Body

Response