Skip to main content
PATCH
Update an agent

Authorizations

Authorization
string
header
required

Your LITELLM_MASTER_KEY. Default for local Docker Compose: sk-local

Path Parameters

agent_id
string
required

Body

application/json
name
string
required
Example:

"my-agent"

owner_id
string
required
Example:

"local-user"

runtime
string

Built-in runtime ID or registered runtime harness alias. Stored in agent config.

Example:

"cursor"

model
string
Example:

"claude-opus-4-5"

system
string
Example:

"You are a helpful assistant."

description
string
prompt
string

Fallback system prompt when system is omitted.

config
object
tools
object

Response

Updated agent

id
string
name
string
Example:

"my-agent"

model
string
Example:

"claude-opus-4-5"

system
string
tools
object
config
object

Runtime-specific config. For runtime-backed agents this usually includes runtime.

owner_id
string | null
status
string
Example:

"paused"

description
string | null
harness
string
Example:

"claude-code"

created_at
integer<int64>