Update an Agent
Update an Agent. The request enforces Agent roles, ownership, workspace boundaries, and lifecycle state.
curl --request PATCH \
--url https://api.revoengine.com/api/v1/agents/{agentId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Ops escalation coordinator"
}
'const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: 'Ops escalation coordinator'})
};
fetch('https://api.revoengine.com/api/v1/agents/{agentId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.revoengine.com/api/v1/agents/{agentId}"
payload = { "name": "Ops escalation coordinator" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)Authorizations
Bearer JWT token or API Key (sk-*).
Path Parameters
Body
Updated display name of the agent.
1"Ops escalation coordinator"
Updated operator-facing description.
"Owns production escalations and stakeholder updates."
Optional status transition, for example ACTIVE or PAUSED.
ACTIVE, PAUSED, DISABLED "PAUSED"
Replacement service-account execution principal.
"11111111-1111-4111-8111-111111111111"
Updated owner id.
"22222222-2222-4222-8222-222222222222"
Updated owner type.
"GROUP"
Replacement resource metadata. Values may use any JSON type. Maximum 16 KiB and 64 top-level keys. Top-level keys starting with "__" are reserved for backend use.
{ "costCenter": "platform" }
Replacement Agent identity and runtime defaults.
Show child attributes
Show child attributes
{
"model": "configured-model",
"executionMode": "agent_loop",
"maxActiveRootRuns": 2,
"maxConcurrentChildRuns": 2,
"maxTicks": 120
}
Replacement persisted policy constraints. Execution-time route metadata stays derived from the current turn.
Show child attributes
Show child attributes
{
"toolNames": ["slack.send_message"],
"maxConcurrentChildRuns": 2,
"maxTicks": 24
}
Optimistic locking version.
x >= 012
Response
curl --request PATCH \
--url https://api.revoengine.com/api/v1/agents/{agentId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Ops escalation coordinator"
}
'const options = {
method: 'PATCH',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: 'Ops escalation coordinator'})
};
fetch('https://api.revoengine.com/api/v1/agents/{agentId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.revoengine.com/api/v1/agents/{agentId}"
payload = { "name": "Ops escalation coordinator" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)