Create a realtime run
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)"{\"type\":\"run.created\",\"run_id\":\"11111111-1111-4111-8111-111111111111\",\"agent_id\":\"00000000-0000-4000-8000-000000000000\",\"conversation_id\":\"22222222-2222-4222-8222-222222222222\",\"model\":\"anthropic/claude-haiku-4-5\",\"render_protocol\":1}\n{\"type\":\"thinking.started\"}\n{\"type\":\"thinking.delta\",\"delta\":\"Find the latest quarter\"}\n{\"type\":\"thinking.completed\"}\n{\"type\":\"output_text.delta\",\"delta\":\"Hello\"}\n{\"type\":\"run.completed\",\"run_id\":\"11111111-1111-4111-8111-111111111111\",\"status\":\"completed\",\"result\":{\"text\":\"Hello\",\"blocks\":[{\"type\":\"thinking\"},{\"type\":\"text\",\"content\":\"Hello\"}]}}\n"Agent Runs
Create a realtime run
Start a CREAO CLI run and stream public events.
POST
/
v1
/
realtime
/
runs
Create a realtime run
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)"{\"type\":\"run.created\",\"run_id\":\"11111111-1111-4111-8111-111111111111\",\"agent_id\":\"00000000-0000-4000-8000-000000000000\",\"conversation_id\":\"22222222-2222-4222-8222-222222222222\",\"model\":\"anthropic/claude-haiku-4-5\",\"render_protocol\":1}\n{\"type\":\"thinking.started\"}\n{\"type\":\"thinking.delta\",\"delta\":\"Find the latest quarter\"}\n{\"type\":\"thinking.completed\"}\n{\"type\":\"output_text.delta\",\"delta\":\"Hello\"}\n{\"type\":\"run.completed\",\"run_id\":\"11111111-1111-4111-8111-111111111111\",\"status\":\"completed\",\"result\":{\"text\":\"Hello\",\"blocks\":[{\"type\":\"thinking\"},{\"type\":\"text\",\"content\":\"Hello\"}]}}\n"Authorizations
bearerAuthapiKeyQuery
Body
application/json
Model id to run with (for example, anthropic/claude-haiku-4-5). Omit to use the agent's default model and thinking level (see default_model_id on the agent), or anthropic/claude-sonnet-5-5 when the agent has none. 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:
100Response
Public NDJSON render stream. One JSON object per line.