Pular para o conteúdo principal

Aprovações de operação

O que aconteceu com uma operação enviada para aprovação por link. Duas tools somente leitura, disponíveis para todo cliente conectado: elas só informam — nenhuma aprova, cancela ou reabre uma aprovação.

Uma tool destrutiva chamada por um cliente que não consegue confirmar no chat responde approval_required com um approval.id e uma URL. Mostre a URL à pessoa e não chame a tool de novo. Depois que a pessoa disser que escolheu Continuar ou Cancelar, chame operation_approvals_get com esse approval.id — uma vez, não em loop.

As duas tools enxergam só as suas próprias aprovações — da pessoa do token — na organização do token e no workspace da conexão. Não exigem escopo de recurso específico nem permissão — o dado é seu —, mas, diferente de me, o token precisa de alcance: algum escopo inbox/… ou um all solto (senão INSUFFICIENT_SCOPE com details.required: ["inbox/all"]). Já o resultado (result, error) é dado do recurso: só aparece quando o token alcança aquele recurso e você ainda tem a permissão de leitura dele; senão fica retido e result_hidden vem true.


operation_approvals_get​

Leitura · alcance (algum inbox/… ou all) · sem permissão · membro ativo · GET /operation-approvals/{id}

Uma aprovação, pelo approval.id da resposta approval_required. Aprovação de outra pessoa, de outra organização ou id que não existe respondem o mesmo NOT_FOUND — a tool não revela que ela existe.

ParâmetroTipoDescrição
id obrigatóriostring (uuid)O approval.id da resposta approval_required.
{
"data": {
"id": "2b0f8c1e-…",
"status": "executed",
"action": "webhooks_regenerate_secret",
"title": "Trocar o segredo de assinatura do webhook",
"resource": "webhooks",
"operation": "regenerate_secret",
"requested_at": "2026-10-31T12:00:00.000Z",
"expires_at": "2026-10-31T12:15:00.000Z",
"decided_at": "2026-10-31T12:03:10.000Z",
"executed_at": "2026-10-31T12:03:10.400Z",
"error": null,
"result": { "data": { "id": "…", "signing_secret": "[redacted]" } },
"result_hidden": false
}
}
CampoSignificado
statuspending, approved (escolheram Continuar e ainda está rodando), executed, failed, declined (Cancelar) ou expired. Uma pendente depois de expires_at já sai como expired.
actionA tool pedida.
titleA operação, como a tela de aprovação a chama, no idioma do pedido (Accept-Language; português por padrão, inglês ou espanhol).
resource / operationEm que a operação age e o que ela faz ali.
requested_at / expires_at / decided_at / executed_atQuando foi pedida, até quando o link valia, quando a pessoa decidiu e quando executou.
error{ code, message } quando failed — p. ex. SUBJECT_CHANGED quando o registro mudou depois que a tela foi mostrada; null nos outros casos.
resultO que a tool devolveu quando executed, com todo segredo mascarado ([redacted]): um segredo de uso único aparece uma vez só, na tela de aprovação. null nos outros casos.

| result_hidden | true quando este token não pode ler o recurso da aprovação (inbox/<recurso> — p. ex. inbox/webhooks para webhooks_regenerate_secret — ou um nível de acesso que o alcance) — e, como em toda leitura, você ainda tem a permissão de leitura desse recurso (<recurso>.show) na organização. Senão result e error vêm null, aconteça o que acontecer. Os outros campos aparecem. |

O link da aprovação, o token dele e o card que a pessoa viu nunca são devolvidos.

operation_approvals_list​

Leitura · alcance (algum inbox/… ou all) · sem permissão · membro ativo · GET /operation-approvals

Suas aprovações no workspace, da mais recente para a mais antiga, com os mesmos campos de operation_approvals_get. Paginada por página: { data, meta: { total, page, per_page, total_pages } }.

ParâmetroTipoDescrição
statusstringSó aprovações neste status: pending, approved, executed, failed, declined ou expired (uma pendente vencida conta como expired, não pending).
created_afterstringPedidas neste instante ISO 8601 ou depois.
created_beforestringPedidas neste instante ISO 8601 ou antes.
pageintegerNúmero da página, padrão 1.
per_pageintegerTamanho da página, padrão 25, máximo 100.