Skip to content

Get agent detail

GET
/api/v1/agents/{role}

Return full configuration for a specific agent role.

Authorizations

Parameters

Path Parameters

role
required

The agent role identifier

string

The agent role identifier

Responses

200

Successful Response

Wrapper response for GET /agents/{role}.

Attributes: data: The agent detail payload.

object
data
required

Detail payload for GET /agents/{role}.

Attributes: config: The full agent configuration.

object
config
required

Full agent config returned by GET /agents/{role}.

Attributes: id: Unique agent config identifier. role: Agent role identifier. display_name: Human-readable name. agent_name: Optional persona name. status: Lifecycle status. model_tier: The LLM tier. autonomy_overrides: Per-agent autonomy level overrides. tools_enabled: List of enabled tool names. color: Optional hex color. forged: Whether this is a custom-forged agent. character_profile: Optional personality traits dict.

object
agent_name
required
Any of:
string
autonomy_overrides
required
object
key
additional properties
any
character_profile
Any of:
object
key
additional properties
any
color
required
Any of:
string
display_name
required
string
forged
required
boolean
id
required
string format: uuid
model_tier
required
string
role
required
string
status
required
string
tools_enabled
required
Array<string>

422

Validation Error

object
detail
Array<object>
object
ctx
object
input
loc
required
Array
msg
required
string
type
required
string