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."
}
'const url = 'https://developer.creao.ai/v1/agents/{agent_id}';
const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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.'
})
};
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}"
payload = {
"skill_content": "# Equity Research Agent
Build a stock memo with an executive summary, valuation sensitivity, key risks, and citations.",
"release_note": "Add valuation sensitivity section."
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"version": "<string>",
"status": "<string>",
"write_autonomy": "full_auto",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"skill_content": "<string>",
"config_content": "<string>",
"config": {},
"dashboard_template": {}
}Update an agent
Replace provided fields on a personal CREAO agent.
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."
}
'const url = 'https://developer.creao.ai/v1/agents/{agent_id}';
const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
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.'
})
};
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}"
payload = {
"skill_content": "# Equity Research Agent
Build a stock memo with an executive summary, valuation sensitivity, key risks, and citations.",
"release_note": "Add valuation sensitivity section."
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"version": "<string>",
"status": "<string>",
"write_autonomy": "full_auto",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"skill_content": "<string>",
"config_content": "<string>",
"config": {},
"dashboard_template": {}
}Authorizations
Account API key from Developer Console. Keys start with cr_sk_.
Path Parameters
Personal CREAO agent to update.
Body
1 - 255Replacement Markdown skill definition. UTF-8 content must be 256 KB or smaller.
262144Replacement app config YAML. If config is also supplied, config wins for parsed config.
131072Replace or clear the dashboard template.
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 Optional changelog note for the update.
2000Response
Agent updated.
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.