Skip to main content
PATCH
/
v1
/
agents
/
{agent_id}
Update agent by replacing provided fields
curl --request PATCH \
  --url https://developer.creao.ai/v1/agents/{agent_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "skill_content": "# Equity Research Agent\n\nBuild a stock memo with an executive summary, valuation sensitivity, key risks, and citations.",
  "release_note": "Add valuation sensitivity section."
}
'
{
  "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "description": "<string>",
  "version": "<string>",
  "status": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

​
Authorization
string
header
default:cr_sk_your_key_here
required

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

Path Parameters

​
agent_id
string<uuid>
required

Personal CREAO agent to update.

Body

application/json
​
name
string
Required string length: 1 - 255
​
description
string | null
​
version
string
​
skill_content
string

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

Maximum string length: 262144
​
config_content
string

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

Maximum string length: 131072
​
config
object
​
dashboard_template
object | null

Replace or clear the dashboard template.

​
write_autonomy
enum<string>

External write autonomy for guarded connector actions.

Available options:
full_auto,
approval_required,
blocked
​
release_note
string | null

Optional changelog note for the update.

Maximum string length: 2000

Response

Agent updated.

​
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