---
title: "Revoke a subscription"
method: DELETE
path: "/api/v1/webhooks/subscriptions"
---

# Revoke a subscription

`DELETE /api/v1/webhooks/subscriptions`

## Request

- Base URL: `https://scope.bid`
- URL: `https://scope.bid/api/v1/webhooks/subscriptions`
- Auth: HTTP bearer

A partner token needs the read or govern scope and revokes only the subscriptions that partner created. A firm caller (session or PAT) needs settings.write or must be a firm admin. Revoking a subscription that is already revoked answers 200.

## Query parameters

- `id` string, required

## Response `200`

Revoked.

## Other responses

- `400`: 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`: No subscription with this id at this firm (for a partner: none it created), including an id that is not a uuid. Nothing was revoked.
- `429`: Per-tenant rate limit exceeded.
- `500`: Database error. Nothing was revoked.
- `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)