Skip to main content
POST
/
v1
/
agents
Create an agent
curl --request POST \
  --url https://developer.creao.ai/v1/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Equity Research Agent",
  "skill_content": "# Equity Research Agent\n\nBuild a concise stock analysis memo from the provided ticker, company, and reporting period."
}
'
{
  "agent_id": "00000000-0000-4000-8000-000000000000",
  "name": "Equity Research Agent",
  "description": "Builds a stock analysis memo from public filings and price history.",
  "version": "0.1",
  "status": "active",
  "write_autonomy": "full_auto",
  "created_at": "2026-07-03T00:00:00.000Z",
  "updated_at": "2026-07-03T00:00:00.000Z"
}

Authorizations

Authorization
string
header
default:cr_sk_your_key_here
required

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

Body

application/json
name
string
required

Agent name.

Required string length: 1 - 255
skill_content
string
required

Markdown skill definition. Serialized UTF-8 content must be 256 KB or smaller.

Maximum string length: 262144
description
string | null

Optional public developer-facing description.

version
string
default:0.1

User-facing version string.

config_content
string

Optional app config YAML. If config is also supplied, config wins for parsed config.

Maximum string length: 131072
config
object

Optional parsed app config object.

dashboard_template
object

JSON-render dashboard template. Serialized JSON must be 512 KB or smaller.

write_autonomy
enum<string>

External write autonomy for guarded connector actions.

Available options:
full_auto,
approval_required,
blocked

Response

Agent created.

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.

Available options:
full_auto,
approval_required,
blocked
created_at
string<date-time>
required
updated_at
string<date-time>
required