---
title: "Revoke a partner grant"
method: DELETE
path: "/api/v1/partner-authorizations"
---

# Revoke a partner grant

`DELETE /api/v1/partner-authorizations`

## Request

- Base URL: `https://scope.bid`
- URL: `https://scope.bid/api/v1/partner-authorizations`
- Auth: HTTP bearer

The caller (session or PAT) needs users.manage or must be a firm admin. A partner token cannot manage grants. Also deactivates that partner's webhook subscriptions for this firm. Revoking a grant that is already revoked answers 200.

## Query parameters

- `partner_id` string, required

## Response `200`

Revoked.

## Other responses

- `400`: partner_id is required.
- `401`: Missing or invalid access token.
- `403`: The caller is not authorized: the caller's role does not grant the required capability, the partner token lacks the required scope, or the partner is not authorized to act for this firm.
- `404`: This firm has no grant to this partner (a partner_id that is not a uuid included). Nothing was revoked.
- `429`: Per-tenant rate limit exceeded.
- `500`: Either a database error left the grant unchanged, or the grant WAS revoked but the partner's webhook subscriptions for this firm were not deactivated (deliveries to them stop anyway). The error text says which; retrying deactivates the subscriptions.
- `503`: Scope could not confirm the caller's role at the firm. Nothing was revoked. Retry.

---

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