Skip to main content
POST
Create an agent

Authorizations

Authorization
string
header
default:cr_sk_your_key_here
required

Account API key from Developer Console. Keys start with cr_sk_.

Body

input
string
required

Natural-language request describing the agent to create. Serialized input must be 256 KB or smaller.

Maximum string length: 262144
model
string

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.

Maximum string length: 100
conversation_id
string<uuid>

Existing creation conversation to continue. Omit to create a new conversation.

webhook_url
string<uri>

Public http or https URL for the terminal agent-creation result.

Maximum string length: 2048

Response

Agent created from the bundle and saved as its first version.

agent_id
string<uuid>
required

Personal CREAO agent ID.

name
string
required
description
string | null
required
version
string
required
status
string
required

Current agent status. Created agents return active.

write_autonomy
enum<string>
required

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.

Available options:
full_auto,
approval_required,
blocked
default_model_id
string | null
required

Model the agent runs with when a run omits model. null means CREAO chooses the model automatically.

default_thinking_level
enum<string> | null
required

Thinking level saved for default_model_id. null means the model's own default.

Available options:
low,
medium,
high,
xhigh,
max
created_at
string<date-time>
required
updated_at
string<date-time>
required
skill_content
string | null

Full SKILL.md. Present on GET-by-id and PATCH. Omitted from list responses.

config_content
string | null

Raw config YAML. Present on GET-by-id and PATCH. Omitted from list responses.

config
object | null

Parsed config object. Present on GET-by-id and PATCH. Omitted from list responses.

dashboard_template
object | null

Dashboard template. Present on GET-by-id and PATCH. Omitted from list responses.

latest_version
object | null

The agent's highest saved version, the floor for the next Replace an agent. Present on GET-by-id, create from a bundle and replace; null until the agent has a saved version.

files
object[]

The agent's file space, up to 50 files. Present on GET-by-id only. Omitted from list and PATCH responses.