Webhooks

Delete a webhook endpoint

Deletes the endpoint and answers 204 with no body. Nothing more is delivered to it: events still queued are closed as FAILED (endpoint no longer exists), and its delivery history is no longer readable. To stop deliveries and keep the endpoint, PUT it with enabled: false.

delete/api/v1/webhook-endpoints/{id}

Request

  • Base URL: https://api.imagestep.dev
  • URL: https://api.imagestep.dev/api/v1/webhook-endpoints/{id}
  • Auth: API key in header Authorization

Path parameters

idstring required

The endpoint's id (whe_…), as create and the listing return it

Headers

Idempotency-Keystring

Optional. A client-generated unique key (typically a UUID). Same key + the same request (method, path, query string and body) replays the first response verbatim with Idempotency-Replayed: true, without executing again. Same key + a different one returns 409 idempotency_key_reuse. A repeat that arrives while the first is still running returns 409 request_in_progress, which is retryable. Keys are retained 24 hours. At most 255 characters; a longer one is a 400 invalid_param with param: "Idempotency-Key".

Response

Deleted

Changes

No recorded changes to this operation across all 1 revision of this API.