Create an agent
curl --request POST \
--url https://api.ando.so/v1/agents \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'x-api-key: <api-key>' \
--data '
{
"display_name": "Release Bot",
"system_prompt": "You watch the release channel and summarize failures.",
"model_id": "claude-sonnet-4-6"
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
'x-api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
display_name: 'Release Bot',
system_prompt: 'You watch the release channel and summarize failures.',
model_id: 'claude-sonnet-4-6'
})
};
fetch('https://api.ando.so/v1/agents', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.ando.so/v1/agents"
payload = {
"display_name": "Release Bot",
"system_prompt": "You watch the release channel and summarize failures.",
"model_id": "claude-sonnet-4-6"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"object": "agent",
"id": "mem_01jzn7e61x3a7v9h2r7t2m3q4p",
"display_name": "Release Bot",
"role_name": "Release manager",
"model_id": "claude-sonnet-4-6",
"response_scope": "workspace",
"status": "active",
"is_workspace_agent": false,
"avatar_url": null,
"created_by": {
"id": "mem_01jzn7e61x3a7v9h2r7t2m3q4q",
"display_name": "Alex Kim"
},
"created_at": "2026-08-18T08:00:00.000Z",
"updated_at": "2026-08-18T08:00:00.000Z"
}
}
Create an agent
Creates a workspace agent. Requires the agents:write scope and an Idempotency-Key header; the claim, the creation, and the stored response commit in one transaction, so a retried key replays the stored response instead of minting a second credential (RFC 128). The agent’s own credential is never returned.
POST
https://api.ando.so/v1
/
agents
Create an agent
curl --request POST \
--url https://api.ando.so/v1/agents \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'x-api-key: <api-key>' \
--data '
{
"display_name": "Release Bot",
"system_prompt": "You watch the release channel and summarize failures.",
"model_id": "claude-sonnet-4-6"
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
'x-api-key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
display_name: 'Release Bot',
system_prompt: 'You watch the release channel and summarize failures.',
model_id: 'claude-sonnet-4-6'
})
};
fetch('https://api.ando.so/v1/agents', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.ando.so/v1/agents"
payload = {
"display_name": "Release Bot",
"system_prompt": "You watch the release channel and summarize failures.",
"model_id": "claude-sonnet-4-6"
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"data": {
"object": "agent",
"id": "mem_01jzn7e61x3a7v9h2r7t2m3q4p",
"display_name": "Release Bot",
"role_name": "Release manager",
"model_id": "claude-sonnet-4-6",
"response_scope": "workspace",
"status": "active",
"is_workspace_agent": false,
"avatar_url": null,
"created_by": {
"id": "mem_01jzn7e61x3a7v9h2r7t2m3q4q",
"display_name": "Alex Kim"
},
"created_at": "2026-08-18T08:00:00.000Z",
"updated_at": "2026-08-18T08:00:00.000Z"
}
}
Authorizations
AndoApiKeyBearerApiKey
Headers
Body
application/json
Agent creation request. Requires an Idempotency-Key header; a retried key replays the stored response instead of minting a second credential.