List agents

GET

/api/v1/agents

• Production
• Local development

Return all agent configs for the authenticated tenant.

Authorizations

• ApiKeyAuth

Responses

200

Successful Response

Wrapper response for GET /agents.

Attributes: data: The agent list payload.

object

data

required

Payload for GET /agents list response.

Attributes: agents: List of agent summaries. total: Total count.

object

agents

required

Array<object>

Compact agent representation for the list endpoint.

Attributes: role: Agent role identifier (e.g. "cmo"). display_name: Human-readable name. agent_name: Optional persona name. status: Lifecycle status ("active" | "paused"). model_tier: The LLM tier this agent uses. color: Optional hex color for UI display. forged: Whether this is a custom-forged agent.

object

agent_name

required

Any of:

string

string

null

null

color

required

Any of:

string

string

null

null

display_name

required

string

forged

required

boolean

model_tier

required

string

role

required

string

status

required

string

total

required

integer