Delete Webhook Endpoint

Permanently removes a webhook endpoint. Pending deliveries are discarded. Deleting and re-creating is also how you rotate the signing secret — the new endpoint gets a new one.

If you only want to pause delivery, set status to DISABLED instead.

Requirements: webhooks:manage scope.

Request

endpointIdstringpathrequired

The webhook endpoint ID to remove.

Response

webhookEndpointobject

Final snapshot of the removed endpoint: {id, url, eventTypes, status, createdAt, consecutiveFailures, disabledAt, disabledReason}.

deletedboolean

Always true on success.

Errors

Status	code	Meaning
401	UNAUTHORIZED	Missing, invalid, or revoked token
403	FORBIDDEN	Token lacks webhooks:manage
404	NOT_FOUND	No endpoint with this ID on this install

Request examples

curl

curl -sS -X DELETE https://app.opentrain.ai/api/partner/v1/webhook-endpoints/<ENDPOINT_ID> \
  -H "Authorization: Bearer $OT_PARTNER_TOKEN"

Response examples

200

{
  "webhookEndpoint": {
    "id": "<ENDPOINT_ID>",
    "url": "https://your-platform.example.com/webhooks/opentrain",
    "eventTypes": ["contract.started", "contract.ended"],
    "status": "ACTIVE",
    "createdAt": "2026-06-12T10:00:00.000Z",
    "consecutiveFailures": 0,
    "disabledAt": null,
    "disabledReason": null
  },
  "deleted": true
}