Pular para o conteúdo

Listar agentes — GET /v1/agents

Lista os agentes ativos da organização associada ao token.

Exige um token com escopo agents:read. Um token de widget (vinculado a um único agente) recebe 403 Forbidden nesta rota — ela é pensada para acesso à organização inteira, não a um agente específico.

GET /v1/agents
Authorization: Bearer f2a_live_...
{
"agents": [
{ "id": "uuid", "name": "Suporte ao Cliente", "category": "Atendimento" }
]
}

category vem como null quando o agente não tem categoria definida. Apenas agentes com status ativo aparecem — agentes pausados ou em rascunho não são listados aqui.