Skip to main content
GET
Get agent

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

Response

Agent object with skill and config fields.

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