Webhooks

Revoke a webhook endpoint

Revoke an endpoint so no additional events are scheduled for delivery to it.

DELETE/webhooks/{webhookId}

API key permission: webhooks:write. Send a unique Idempotency-Key and reuse it only when retrying the same request.

Parameters

NameTypeDescription

webhookIdstring · required

path parameter

Idempotency-Keystring · required

Unique operation key. Reuse it only with the same method, path, and request body.

Standard response headers

HeaderExampleDescription

Stepes-Request-Idb09de4aa-3874-4991-b85c-0bc86e780511

Server-generated request identifier for support and audit correlation.

Stepes-API-Version2.0.0

Effective Stepes API semantic version.

RateLimit-Policy120;w=60

Effective request limit and window for the authenticated key.

RateLimitlimit=120, remaining=119, reset=60

Current limit, remaining requests, and reset interval.

Idempotency-Replayedtrue

Present with value true when a stored mutation response is replayed.

Responses

204

Webhook revoked

404

Resource was not found or is not available to this API key

Request example

Production

curl --request DELETE \
  --url https://apis.stepes.com/v2/webhooks/{webhookId} \
  --header 'Authorization: Bearer stp_live_<your-api-key>' \
  --header 'Idempotency-Key: <unique-operation-key>'

Copy this example and replace the placeholder values with your own.

For security, this documentation site never sends requests using your API key.