Agents

List available agents and manage the active agent roster.

Agent endpoints expose the available catalog and the active roster in the current context.

List agents

GET /v1/agents
Authorization: Bearer <token>

The response includes:

Field	Meaning
`agents`	Available agent catalog
`activeAgents`	Installed agents active in this context

PUT /v1/agents
Authorization: Bearer <token>
Content-Type: application/json
 
{ "agentIds": ["agent_a", "agent_b"] }

Unknown agent IDs return 400.

DELETE /v1/agents
Authorization: Bearer <token>
Content-Type: application/json
 
{ "agentIds": ["agent_a"] }

After removal, the response returns the updated activeAgents list.