Skip to main content
PATCH
Update agent settings

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
write_autonomy
enum<string>

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

Model the agent runs with when a run omits model (for example, anthropic/claude-sonnet-5-5). Accepts any model offered in the CREAO app's model picker, including models not listed on https://agent.docs.creao.ai/developer-api/supported-models. Setting it pins this exact model, replacing automatic model selection. Changing the model without also sending default_thinking_level clears the saved thinking level. Unknown ids return 400 MODEL_NOT_SUPPORTED; models not available on your plan return 403 MODEL_NOT_ALLOWED.

Required string length: 1 - 255
default_thinking_level
enum<string> | null

Thinking level for the agent's default model. null clears it so the model's own default applies. Requires a pinned model: when the agent's model is chosen automatically, send default_model_id in the same request or the update returns 400 AGENT_THINKING_NOT_APPLICABLE.

Available options:
low,
medium,
high,
xhigh,
max

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 (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.