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. 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.

Response

Server-Sent Events stream.

The response is of type string.