multi-router.aidocs

API Reference

AgentsEnterprise

Listing and retiring the agents people set up from the Portal.

An agent is the router and API key a person sets up for an AI tool from the Portal. The agents endpoints list active agents and retire them; agents are created from the Portal, not the API. See Managing Agents.

MethodPathDescriptionScope
GET/v1/agentsList active agents. Filter with person_id and router_id. Paginated.agents:read
GET/v1/agents/{id}Get one agent.agents:read
DELETE/v1/agents/{id}Retire an agent, with its router and API key. Needs a key of the account organization.agents:delete

Each agent has its wl_ id, person_id, router_id, token_id, profile_id and created_at.

Retire an agentbash
curl -X DELETE https://api.multi-router.ai/v1/agents/wl_5Np8Rk2VxT \
  -H "Authorization: Bearer $MR_API_KEY"
CodeStatusMeaning
invalid_filter400A filter value is invalid.
account_token_required403A delete uses a key of a named organization.
router_scoped_token403The key is limited to some routers.
agent_not_found404No active agent has that id.
agent_router_has_aliases409The agent's router has aliases. Detach them first.
BudgetsOrganizations
Was this helpful?