Delete a webhook subscription

Delete an account-owned subscription by ID. Use delete and recreate when you need a new signing secret, destination, or event selection.

DELETE/api/v1/webhook-subscriptions/{id}204 No Content

Use this endpoint OpenAPI spec

Authentication

Send an active Fast Transcriber API key as an HTTP bearer token.

Authorization: Bearer ft_live_replace_me

Request

This operation has no request body or parameters.

No request fields.

curl --request DELETE https://fast-transcriber.com/api/v1/webhook-subscriptions/b7140faa-1234-4abc-9def-0123456789ab \
  --header "Authorization: Bearer $FAST_TRANSCRIBER_API_TOKEN"

Response

Successful JSON responses use a top-level data envelope. A 204 response has no body.

Successful response has no body.

Errors

API errors return a machine-readable code and message.

Status	Code	Meaning
401	`missing_api_key`	No bearer key was supplied.
401	`invalid_api_key`	The bearer key is malformed, unknown, or revoked.
404	`not_found`	The subscription does not exist or belongs to a different API account.

Implementation notes

Replace {id} with the subscription ID returned by create or list; the operation has no request body.
A successful deletion returns an empty response body and prevents new delivery attempts for that subscription.
To rotate a signing secret, delete the old subscription, create its replacement, update the receiver, and retain webhook-id deduplication during the transition.