Create an agent
Create a personal CREAO agent through the Developer API.
Authorizations
Account API key from Developer Console. Keys start with cr_sk_.
Body
Natural-language request describing the agent to create. Serialized input must be 256 KB or smaller.
262144Model id to run with (for example, anthropic/claude-haiku-4-5). Omit to use the default model, currently anthropic/claude-sonnet-5. Supported ids: GET /v1/models. Unknown ids return 400 MODEL_NOT_SUPPORTED; models not available on your plan return 403 MODEL_NOT_ALLOWED.
100Existing creation conversation to continue. Omit to create a new conversation.
Public http or https URL for the terminal agent-creation result.
2048Response
Agent creation 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.