curl --request POST \
--url https://developer.creao.ai/v1/realtime/runs \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"agent_id": "00000000-0000-4000-8000-000000000000",
"input": {
"query": "Summarize the latest quarterly report."
}
}
'const url = 'https://developer.creao.ai/v1/realtime/runs';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
agent_id: '00000000-0000-4000-8000-000000000000',
input: {query: 'Summarize the latest quarterly report.'}
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://developer.creao.ai/v1/realtime/runs"
payload = {
"agent_id": "00000000-0000-4000-8000-000000000000",
"input": { "query": "Summarize the latest quarterly report." }
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)Create a realtime run
Start a CREAO CLI run and stream public events.
curl --request POST \
--url https://developer.creao.ai/v1/realtime/runs \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"agent_id": "00000000-0000-4000-8000-000000000000",
"input": {
"query": "Summarize the latest quarterly report."
}
}
'const url = 'https://developer.creao.ai/v1/realtime/runs';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
agent_id: '00000000-0000-4000-8000-000000000000',
input: {query: 'Summarize the latest quarterly report.'}
})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://developer.creao.ai/v1/realtime/runs"
payload = {
"agent_id": "00000000-0000-4000-8000-000000000000",
"input": { "query": "Summarize the latest quarterly report." }
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)Authorizations
Account API key from Developer Console. Keys start with cr_sk_.
Body
Active personal CREAO agent to run.
JSON input for the agent. Serialized input must be 256 KB or smaller.
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.
100Existing conversation to continue. Omit to create a new conversation.
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.