O que falta autorizar para conversar
Lista as conexões em modo "usuário que conversa" que a pessoa desta credencial ainda não autorizou na própria conta. A aplicação consulta antes de enviar a mensagem para desenhar o próprio pedido de autorização; o disparo do run recusa com 409 de qualquer forma. `ready: false` com `pending` vazio significa que não foi possível verificar agora (veja `unreadable`) — tente de novo, não peça autorização. Exige o escopo runs:read.
Authorization
chaveDeApi Chave de API da organização, criada nas configurações. Envie-a em Authorization: Bearer <sua chave>.
In: header
Path Parameters
Identificador do agente.
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/agents/string/authorizations"{ "ready": true, "unreadable": true, "pending": [ { "kind": "mcp", "id": "string", "name": "string", "expired": true } ]}Cancelar uma execução
Para a execução em andamento. As etapas vivas são canceladas em cascata, e um `callback_url` registrado recebe o POST com `status: cancelled`. Exige o escopo runs:execute.
Registrar a credencial desta pessoa nas ferramentas da aplicação
Guarda o token que o agente deve apresentar aos servidores de ferramentas (MCP) desta aplicação quando esta pessoa está conversando. Chamar de novo rotaciona. A pessoa e a aplicação vêm da credencial que autentica a chamada — não do corpo. Não exige escopo: a operação é sobre a própria conta, não sobre recursos da organização. A plataforma não descobre sozinha que o token do outro lado morreu: rotacione ou remova aqui no mesmo momento em que ele muda na aplicação.