curl --request POST \
--url https://developer.creao.ai/v1/super-agent/runs \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"input": {
"query": "Summarize recent Solana TVL changes."
}
}
'const url = 'https://developer.creao.ai/v1/super-agent/runs';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({input: {query: 'Summarize recent Solana TVL changes.'}})
};
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/super-agent/runs"
payload = { "input": { "query": "Summarize recent Solana TVL changes." } }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"run_id": "11111111-1111-4111-8111-111111111111",
"status": "pending",
"agent_id": null,
"conversation_id": "22222222-2222-4222-8222-222222222222",
"model": "anthropic/claude-haiku-4-5"
}Create a Super Agent async run
Start a background Super Agent conversation.
curl --request POST \
--url https://developer.creao.ai/v1/super-agent/runs \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"input": {
"query": "Summarize recent Solana TVL changes."
}
}
'const url = 'https://developer.creao.ai/v1/super-agent/runs';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({input: {query: 'Summarize recent Solana TVL changes.'}})
};
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/super-agent/runs"
payload = { "input": { "query": "Summarize recent Solana TVL changes." } }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"run_id": "11111111-1111-4111-8111-111111111111",
"status": "pending",
"agent_id": null,
"conversation_id": "22222222-2222-4222-8222-222222222222",
"model": "anthropic/claude-haiku-4-5"
}Authorizations
Account API key from Developer Console. Keys start with cr_sk_.
Body
JSON input for Super 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. Supported ids: https://agent.docs.creao.ai/developer-api/supported-models.
100Existing Super Agent conversation to continue. Agent Run conversations are rejected.
Personal workspace whose root uploads Super Agent can read.
Public http or https URL for the terminal async result.
2048Optional boolean gate for completion notifications. Not accepted on realtime runs.
Response
Run accepted.
Developer API run ID.
pending, running, completed, failed, cancelled Agent that ran. Creation runs return null until the agent is created, then the completed run includes the new agent ID.
Conversation ID for follow-up runs.
Model id this run executed with. null only for runs created before model selection shipped.
Personal workspace bound to this conversation, when set.
Final agent output. Completed runs commonly include text; agent-creation runs also include agent_id.
Show child attributes
Show child attributes
Settlement credits plus an optional per-model breakdown for the run.
Omitted when the run incurred no cost and collected no model usage.
models is present only for Super Agent–allowlisted accounts.
Token fields appear only for token-metered capabilities. Per-image
and per-second capabilities use generated_images or duration_seconds
instead. kind tells the client which fields apply.
Show child attributes
Show child attributes
Show child attributes
Show child attributes