curl --request POST \
--url https://developer.creao.ai/v1/agents/{agent_id}/edits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"instructions": "Add a valuation sensitivity table for the selected ticker and include a short note on downside risk."
}
'const url = 'https://developer.creao.ai/v1/agents/{agent_id}/edits';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
instructions: 'Add a valuation sensitivity table for the selected ticker and include a short note on downside risk.'
})
};
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/agents/{agent_id}/edits"
payload = { "instructions": "Add a valuation sensitivity table for the selected ticker and include a short note on downside risk." }
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",
"agent_id": "00000000-0000-4000-8000-000000000000",
"status": "queued",
"created_at": "2026-07-03T10:00:00.000Z",
"started_at": null,
"completed_at": null
}Edit an agent from instructions
Start an async natural-language edit for a personal agent.
curl --request POST \
--url https://developer.creao.ai/v1/agents/{agent_id}/edits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"instructions": "Add a valuation sensitivity table for the selected ticker and include a short note on downside risk."
}
'const url = 'https://developer.creao.ai/v1/agents/{agent_id}/edits';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
instructions: 'Add a valuation sensitivity table for the selected ticker and include a short note on downside risk.'
})
};
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/agents/{agent_id}/edits"
payload = { "instructions": "Add a valuation sensitivity table for the selected ticker and include a short note on downside risk." }
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",
"agent_id": "00000000-0000-4000-8000-000000000000",
"status": "queued",
"created_at": "2026-07-03T10:00:00.000Z",
"started_at": null,
"completed_at": null
}Authorizations
Account API key from Developer Console. Keys start with cr_sk_.
Path Parameters
Personal CREAO agent to edit.
Body
Natural-language description of the changes to make to the agent.
1 - 65536Model 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.
100Optional caller-provided release note for the persisted agent update.
2000Response
Agent edit accepted.
Backing CREAO CLI run ID for polling/debugging.
queued, running, succeeded, failed, cancelled Terminal edit result when the edit succeeds.
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