Delete subscription (soft + auto-disable)

Overview

Soft-delete the subscription (sets deleted_at) and force is_active=false in one transaction. This way any already-queued retry attempts exit silently. Delivery-log rows are retained. Soft-deleting frees the delivery_kind slot, so a new subscription of the same kind can be created afterward. No request body required.

Prerequisites

• A bearer token. Callable with Partner tokens.
• The webhookSubscriptionId of the record you are targeting.

Base URL

Endpoint

DELETE /api/v1/partner/webhooks/{webhookSubscriptionId}

Authentication

• Requires a bearer token in the Authorization: Bearer <bearer-token> header.
• Who can call it: Partner tokens.
• findCallerSubscription enforces bundle_id === 1 and scopes by partner_company_id (404 if not owned).

Rate limit

• No rate limit.

Path parameters

Request

• No body.

Response

• data.data.subscription_id (int)
• data.data.status (string) — deleted

200 Success · 200

{ "data": { "data": {
  "subscription_id": 2,
  "status": "deleted"
} } }

Errors

Example request

curl --request DELETE \
  --url "https://production-api.shoutaboutus.com/api/v1/partner/webhooks/123" \
  --header 'Authorization: Bearer {{bearerToken}}' \
  --header 'Accept: application/json'