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

Authorizations

Authorization
string
header
required

Session JWT. After nasiko auth login, print it with jq -r '.clusters[.active].token' ~/.nasiko/config.json. API keys aren't supported.

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
hitl_enabled
boolean | null

Toggle human-in-the-loop approval for this coding agent. Omitted = leave as-is, so an ordinary metadata edit never flips it.

icon_url
string | null
image
string | null
metadata
any
minimal_code_enabled
boolean | null
parking_policy
string | null

auto (the platform may park the agent when idle) or resident (always running). Omitted = leave as-is. A parked agent flipped to resident is woken by its next call and then stays up. A running resident agent flipped to auto is parked once idle; its workload becomes one that can be parked at its next deploy.

skills
object[] | null
status
string | null
tags
string[] | null
url
string | null
version
string | null
workload_kind
string | null

Workload kind: agent, mcp_connector, or acp_coding_agent. Omitted = leave as-is (so an ordinary metadata edit never clears it); present = overwrite, which is how nasiko deploy --coding-agent promotes an already-registered agent to a coding agent.

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

Whether minimal-code guidance is injected into messages sent to this agent. Shown as a switch on the agent's Settings tab.

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 compression on this agent's traffic: payload compression on its LLM calls, brevity, and session-history compression in direct chats. Off unless enabled.

description
string | null
display_name
string | null
documentation_url
string | null
hitl_enabled
boolean

Whether this coding agent gates its tool use behind human approval. Off unless explicitly enabled; only meaningful for workload_kind = acp_coding_agent.

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
workload_kind
string

Workload kind: agent (default), mcp_connector, or acp_coding_agent. Exposed so clients can tell a coding agent apart from a normal one (e.g. nasiko chat labels it, and --coding-agent asserts on it).