Skip to main content
POST
Create a realtime 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
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-5. Supported ids: https://agent.docs.creao.ai/developer-api/supported-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.

Response

Public NDJSON render stream. One JSON object per line.

type
string
required
Allowed value: "run.created"
run_id
string<uuid>
agent_id
string<uuid> | null
conversation_id
string<uuid>
model
string | null
render_protocol
integer