curl --request PUT \
--url https://developer.creao.ai/v1/agents/{agent_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form bundle=@example-fileimport fs from 'fs';
const formData = new FormData();
formData.append('bundle', await new Response(fs.createReadStream('example-file')).blob());
const url = 'https://developer.creao.ai/v1/agents/{agent_id}';
const options = {method: 'PUT', headers: {Authorization: 'Bearer <token>'}, body: formData};
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}"
files = { "bundle": ("example-file", open("example-file", "rb")) }
headers = {"Authorization": "Bearer <token>"}
response = requests.put(url, files=files, headers=headers)
print(response.text){
"agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"version": "<string>",
"status": "<string>",
"write_autonomy": "full_auto",
"default_model_id": "<string>",
"default_thinking_level": "low",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"skill_content": "<string>",
"config_content": "<string>",
"config": {},
"dashboard_template": {},
"latest_version": {
"version_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"version": "<string>",
"created_at": "2023-11-07T05:31:56Z"
},
"files": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"mime_type": "<string>",
"size_bytes": 123,
"sha256": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"download_url": "<string>",
"download_url_expires_at": "2023-11-07T05:31:56Z",
"content": "<string>"
}
]
}Replace an agent
Replace a personal CREAO agent with a zip bundle and save it as a new version.
curl --request PUT \
--url https://developer.creao.ai/v1/agents/{agent_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form bundle=@example-fileimport fs from 'fs';
const formData = new FormData();
formData.append('bundle', await new Response(fs.createReadStream('example-file')).blob());
const url = 'https://developer.creao.ai/v1/agents/{agent_id}';
const options = {method: 'PUT', headers: {Authorization: 'Bearer <token>'}, body: formData};
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}"
files = { "bundle": ("example-file", open("example-file", "rb")) }
headers = {"Authorization": "Bearer <token>"}
response = requests.put(url, files=files, headers=headers)
print(response.text){
"agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"description": "<string>",
"version": "<string>",
"status": "<string>",
"write_autonomy": "full_auto",
"default_model_id": "<string>",
"default_thinking_level": "low",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"skill_content": "<string>",
"config_content": "<string>",
"config": {},
"dashboard_template": {},
"latest_version": {
"version_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"version": "<string>",
"created_at": "2023-11-07T05:31:56Z"
},
"files": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"mime_type": "<string>",
"size_bytes": 123,
"sha256": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"download_url": "<string>",
"download_url_expires_at": "2023-11-07T05:31:56Z",
"content": "<string>"
}
]
}Authorizations
Account API key from Developer Console. Keys start with cr_sk_.
Path Parameters
Personal CREAO agent to replace.
Body
The whole agent as a zip of at most 100 MB:
SKILL.mdat the root (required, at most 256 KB).config.yamlat the root (required, at most 128 KB) withname,version(three numbers such as"1.2.0"; quote it so YAML keeps it as text) and an optionaldescription.dashboard.jsonat the root (optional, at most 512 KB).- Mounted files under
files/, kept at the same relative path in runs. Each file can be up to 20 MB, and an agent holds at most 50 files includingSKILL.md.
manifest.json and files/SKILL.md, which downloaded bundles
carry, are ignored.
Optional note saved with the version.
2000Response
Agent replaced and saved as a new version.
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 Model the agent runs with when a run omits model. null means CREAO chooses the model automatically.
Thinking level saved for default_model_id. null means the model's own default.
low, medium, high, xhigh, max 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.
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.
Show child attributes
Show child attributes
The agent's file space, up to 50 files. Present on GET-by-id only. Omitted from list and PATCH responses.
Show child attributes
Show child attributes