Agents

Agents are AI teammates that can be assigned to work in Epismo, either to a task track or to a step in a workflow pack. Before an agent can be assigned, it has to be active in the current context. These endpoints let your integration read the available catalog and control which agents are active. For the assignment model and where agent IDs are valid, see Agents.

List agents

GET /v1/agents
Authorization: Bearer <token>

The response separates the full catalog from what is active here:

When your integration offers assignee choices, list activeAgents; only active agents are valid assignees.

Add agents

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

Adding an agent makes it available as an assignee in this context. Unknown agent IDs return 400.

Remove agents

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

The response returns the updated activeAgents list. Removing an agent takes it out of future assignment choices; tracks or workflow steps that already reference that agent are not changed, so review them separately if you are decommissioning an agent.