Layers
Partner APIAPI referenceWebhooks

DELETE /v1/webhook-endpoints/:endpointId

Remove a webhook endpoint. Pending deliveries for the endpoint are abandoned.

View as Markdown
DELETE/v1/webhook-endpoints/{endpointId}
Phase 1stableidempotent
Auth
X-Api-Key

Removes the endpoint and cascade-deletes its delivery history. Pending deliveries queued against this endpoint are abandoned (will not fire and will not retry). If you want to stop deliveries temporarily without losing the signing secret or delivery log, use PATCH status: "paused" instead.

Example

curl -X DELETE https://api.layers.com/v1/webhook-endpoints/d4c71b62-... \
  -H "X-Api-Key: $LAYERS_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"
200OK
{ "id": "d4c71b62-7f08-4dc9-9d2c-8f7e2b9c4411", "deleted": true }

Errors

StatusCodeWhen
404NOT_FOUNDEndpoint not owned by the calling org.

On this page