Skip to main content
PUT
Update an agent's catalog metadata. Owner-or-superuser only.

Path Parameters

id
string<uuid>
required

Agent id

Body

application/json
activate_version
boolean

true (the default) for a real deploy — the new version becomes active, archiving whatever was running before. nasiko push sets this false: it only makes an image available in the registry without deploying it, so it must not claim the new version is now active or archive the version that's genuinely still running.

capabilities
any
compress_enabled
boolean | null

Toggle payload compression for this agent. Omitted = leave as-is.

description
string | null
display_name
string | null
documentation_url
string | null
icon_url
string | null
image
string | null
metadata
any
minimal_code_enabled
boolean | null
skills
object[] | null
status
string | null
tags
string[] | null
url
string | null
version
string | null

Response

Updated agent

capabilities
any
required
created_at
string<date-time>
required
default_input_modes
string[]
required
default_output_modes
string[]
required
id
string<uuid>
required
metadata
any
required
minimal_code_enabled
boolean
required

Drives the control plane's own minimal-code ladder injection at A2A dispatch time (a2a_dispatch.rs), not a secret — unlike the old CODING_AGENT_MINIMAL_CODE env var this replaces, this column has a real read-back route, which is what lets the Settings-tab switch show its actual current state instead of a per-browser guess.

name
string
required
owner_id
string<uuid>
required
preferred_transport
string
required
protocol_version
string
required
security_schemes
any
required
skills
object[]
required
status
string
required
tags
string[]
required
updated_at
string<date-time>
required
version
string
required
compress_enabled
boolean

Per-agent opt-in for structural payload compression on this agent's LLM calls (nasiko-compress, applied in the LLM router). Off unless explicitly enabled.

description
string | null
display_name
string | null
documentation_url
string | null
icon_url
string | null
image
string | null
transport_path
string | null

Path of the agent's advertised JSON-RPC transport (e.g. "/jsonrpc"), extracted from its AgentCard supportedInterfaces at deploy time. Clients chat via {base}/api/agents/{id}{transport_path}.

url
string | null