curl --request POST \
--url https://developer.creao.ai/v1/agents \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"input": "Create an equity research agent that writes concise stock analysis memos from a ticker and reporting period."
}
'const url = 'https://developer.creao.ai/v1/agents';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
input: 'Create an equity research agent that writes concise stock analysis memos from a ticker and reporting period.'
})
};
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"
payload = { "input": "Create an equity research agent that writes concise stock analysis memos from a ticker and reporting period." }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)Create an agent
Create a personal CREAO agent through the CREAO CLI.
curl --request POST \
--url https://developer.creao.ai/v1/agents \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"input": "Create an equity research agent that writes concise stock analysis memos from a ticker and reporting period."
}
'const url = 'https://developer.creao.ai/v1/agents';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
input: 'Create an equity research agent that writes concise stock analysis memos from a ticker and reporting period.'
})
};
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"
payload = { "input": "Create an equity research agent that writes concise stock analysis memos from a ticker and reporting period." }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)Authorizations
Body
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.
100Response
Agent created from the bundle and saved as its first version.
External write autonomy for guarded connector actions (write and delete actions in connected services). full_auto performs them immediately. A run started through /v1 cannot collect an approval, so on those runs approval_required and blocked both leave the action unperformed; the run still completes and the agent is told why. In the browser app, approval_required waits for your approval. Reads always run.
full_auto, approval_required, blocked