Responder um card de pergunta
Responde uma pergunta aberta pelo agente com a tool AskUserQuestion, que fica bloqueada esperando. Gravada a resposta, o poll da tool a encontra em até 2s e o MESMO turno segue — não há retomada a disparar. O `requestId` é o que vem no evento `question_asked` do stream de execução ou, no modo assíncrono, em `pending_question.request_id` de GET /v1/runs/{runId}. O `tool_use_id` do step da tool não serve. A permissão é avaliada como a pessoa dona da chave. Exige o escopo runs:execute.
Authorization
chaveDeApi Chave de API da organização, criada nas configurações. Envie-a em Authorization: Bearer <sua chave>.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/v1/questions/answer" \ -H "Content-Type: application/json" \ -d '{ "requestId": "string" }'{ "question": { "id": "string", "status": "answered", "answered_at": "2019-08-24T14:15:22Z" }}Decidir uma aprovação
Aprova ou recusa uma aprovação pendente e retoma o agente. A permissão é avaliada como a pessoa dona da chave. Plano proposto por um turno com `plan_mode: true` não é decidido aqui: a resposta é 400 (`not_a_plan`), e a decisão vai em POST /v1/runs/{runId}/plan. Exige o escopo runs:execute.
Registrar ou atualizar um ativo externo
Idempotente pelo par (asset_type, external_ref): chamar de novo com a mesma referência atualiza o ativo em vez de criar outro. Exige o escopo governance:write.