Skip to content
rigid.fi

Delete a webhook endpoint

DELETE/v1/webhook-endpoints/{id}

Requires an API client bearer token.

Deregisters a webhook endpoint; pending deliveries are dropped. Requires an Idempotency-Key header.

Parameters

Path parameters

NameRequiredDescription
idrequired

Header parameters

NameRequiredDescription
Idempotency-Keyrequired

Client-chosen. An identical retry with the same key returns the stored response; reusing the key with a different payload returns 409.

Example

curl -X DELETE https://api.rigid.fi/v1/webhook-endpoints/{id} \
  -H "Authorization: Bearer $RIGID_API_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)"

Responses

204

Endpoint deleted.

400

Validation error

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring
401

Authentication required

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring
403

Forbidden

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring
404

Webhook endpoint not found

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring
409

Idempotency-Key reused with a different payload

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring
500

Internal server error

typestringrequired
titlestringrequired
statusintegerrequired
detailstring
instancestring