Skip to main content
POST
Register a new agent in the catalog.

Body

application/json
name
string
required
capabilities
any
description
string | null
display_name
string | null
documentation_url
string | null
icon_url
string | null
image
string | null
metadata
any
skills
object[] | null
tags
string[] | null
url
string | null
version
string | null

Response

Agent registered

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