Reference Subscriptions

DELETE

/v1/subscriptions/{subscription_id}

Delete a subscription and stop all future deliveries.

Deletion is immediate and permanent: queued retries are cancelled and the signing secret is invalidated. The delivery log for the subscription remains readable through GET /v1/deliveries. To stop deliveries temporarily, update the subscription with active: false instead.

Jump to the request builder ↓

Parameters

Path parameters

  • subscription_id string required

    Identifier of the subscription to delete.

    Example: sub_9f2c1a

Response

A confirmation object. Deleting an already-deleted subscription returns 404.

200 · application/json
{
  "id": "sub_9f2c1a",
  "object": "subscription",
  "deleted": true
}