curl --request GET \
--url https://developer.creao.ai/v1/agents/{agent_id} \
--header 'Authorization: Bearer <token>'const url = 'https://developer.creao.ai/v1/agents/{agent_id}';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://developer.creao.ai/v1/agents/{agent_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"agent_id": "00000000-0000-4000-8000-000000000000",
"name": "Equity Research Agent",
"description": "Builds a stock analysis memo from public filings.",
"version": "0.1",
"status": "active",
"write_autonomy": "full_auto",
"skill_content": "# Equity Research Agent",
"config_content": "name: Equity Research Agent",
"config": {
"name": "Equity Research Agent"
},
"dashboard_template": null,
"created_at": "2026-07-02T00:00:00.000Z",
"updated_at": "2026-07-03T00:00:00.000Z"
}Get an agent
Fetch a personal CREAO agent including skill and config content.
curl --request GET \
--url https://developer.creao.ai/v1/agents/{agent_id} \
--header 'Authorization: Bearer <token>'const url = 'https://developer.creao.ai/v1/agents/{agent_id}';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));import requests
url = "https://developer.creao.ai/v1/agents/{agent_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"agent_id": "00000000-0000-4000-8000-000000000000",
"name": "Equity Research Agent",
"description": "Builds a stock analysis memo from public filings.",
"version": "0.1",
"status": "active",
"write_autonomy": "full_auto",
"skill_content": "# Equity Research Agent",
"config_content": "name: Equity Research Agent",
"config": {
"name": "Equity Research Agent"
},
"dashboard_template": null,
"created_at": "2026-07-02T00:00:00.000Z",
"updated_at": "2026-07-03T00:00:00.000Z"
}Authorizations
Account API key from Developer Console. Keys start with cr_sk_.
Path Parameters
Personal CREAO agent to fetch.
Response
Agent object with skill and config fields.
Personal CREAO agent ID.
Current agent status. Created agents return active.
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.
full_auto, approval_required, blocked Full SKILL.md. Present on GET-by-id and PATCH. Omitted from list responses.
Raw config YAML. Present on GET-by-id and PATCH. Omitted from list responses.
Parsed config object. Present on GET-by-id and PATCH. Omitted from list responses.
Dashboard template. Present on GET-by-id and PATCH. Omitted from list responses.