v1

latestOpenAPI 3.0.3raw.githubusercontent.com2026-06-1220723.1 KB
Agents

Update an agent

patch/api/v1/managed_agents/agents/{id}

Path parameters

idstring required

Request body

namestring required
runtimestring required

Alias of a registered runtime harness

modelstring required
system_promptstring
memory_enabledboolean
toolsstring[]

Example request

{
  "name": "my-agent",
  "runtime": "cursor",
  "model": "claude-opus-4-5",
  "system_prompt": "You are a helpful assistant.",
  "tools": [
    "bash",
    "file_read",
    "file_write"
  ]
}

Response

Updated agent

idstring
namestring
runtimestring
modelstring
system_promptstring
memory_enabledboolean
toolsstring[]
created_atstring date-time

Example response

{
  "name": "my-agent",
  "runtime": "cursor",
  "model": "claude-opus-4-5",
  "tools": [
    "bash",
    "file_read"
  ]
}