DOM360
Agentes

Listar os alvos de ponte de um agente

GET
/agents/{agent_id}/bridge-targets

Lista os agentes do mesmo cliente do agente de origem que podem ser alvo de uma ponte, opcionalmente filtrados por uma ação (action). O próprio agente de origem não aparece. Fora do alcance responde 404.

Autorização

bearer agents:read
AutorizaçãoBearer <token>

Credencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.

Em: header

Escopo: agents:read

Parâmetros de caminho

agent_id*string

Id do agente

Parâmetros de consulta

action?string

Estreita para os alvos que aceitam esta ação (start_call, send_message ou execute_task).

Valor em

  • "start_call"
  • "send_message"
  • "execute_task"
cursor?string

Cursor opaco devolvido em page.next_cursor da página anterior. Omita para começar do início.

limit?integer

Tamanho da página. Padrão 50; o máximo é o da coleção: 200, ou até 500 nas coleções de itens pequenos.

Formatoint32
Intervalo0 <= value

Corpo da resposta

application/json

application/json

curl -X GET "https://example.com/agents/string/bridge-targets"
{  "data": [    {      "actions": [        "string"      ],      "agent_id": "string",      "name": "string",      "type": "string"    }  ],  "page": {    "has_more": true,    "next_cursor": "string"  }}