---
title: "Record confirmed upstream removal of one terminal Billit grant"
method: POST
path: "/v1/admin/integrations/revoke-grants/{outbox_id}/leak-clearances"
tags: ["admin"]
---

# Record confirmed upstream removal of one terminal Billit grant

`POST /v1/admin/integrations/revoke-grants/{outbox_id}/leak-clearances`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/admin/integrations/revoke-grants/{outbox_id}/leak-clearances`
- Auth: HTTP bearer

Internal admin users only. Records confirmation without a provider call or account-fence change.

## Path parameters

- `outbox_id` string, uuid, required

## Request body

- GrantLeakClearance
  - `upstream_confirmed_revoked` boolean, required: Explicit confirmation that the named grant was removed upstream.

## Response `200`

Successful Response

- GrantLeakClearanceResult
  - `outbox_id` string, uuid, required
  - `tenant_id` string, uuid, required
  - `cleared` boolean, required
  - `refusal` 'upstream_not_confirmed' | 'already_cleared' | 'not_residual' | 'nonterminal'
  - `still_reported_as_orphaned` boolean, required

## Other responses

- `401`: Unauthorized
- `403`: Permission denied (PERMISSION_DENIED) or email not verified (EMAIL_NOT_VERIFIED)
- `404`: Not found
- `409`: Conflict: admin write rejected on a state invariant. Inspect ``errors[0].type`` for the specific case (for example: ``self_action_forbidden``, ``already_disabled``, ``not_disabled``, ``last_internal_admin``, ``value_error``)
- `422`: Validation error

---

[API](https://skmtc.dev/patricia/apis/patricia-api.md) · [All operations](https://skmtc.dev/patricia/apis/patricia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/patricia/apis/patricia-api/revisions/0dfb44495ea1?raw)