Get It Done

Delete a webhook endpoint

DELETE/v1/webhook-endpoints/{endpoint_id}

Permanently (hard) deletes the endpoint — org-scoped, 404 for a cross-org or unknown id — mirroring how `deleteApiKey` hard-deletes a plugin key. The delete CASCADES (schema.prisma `onDelete: Cascade` on WebhookDelivery.endpointId, and from there to WebhookAttempt) to every delivery still queued for this endpoint: pending/in-flight deliveries for this endpoint stop existing rather than being left stuck. DELETE is naturally idempotent by HTTP semantics — this route does not use the Idempotency-Key ledger.

Required scopes

webhooks:write

Availability

Pro & Team plans

Quota cost

1 API call

Idempotency

Not applicable

Request

Path parameters

Field	Type	Description
`endpoint_id`required	string

Response 200

The endpoint was deleted.

Fields

Field	Type	Description
`id`required	string	The id of the deleted endpoint.

▸ Raw response schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The id of the deleted endpoint."
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "description": "Confirmation that the endpoint — and every pending/queued delivery for it — was permanently deleted."
}

Example request

curl

curl -X DELETE https://app.nowgetitdone.com/v1/webhook-endpoints/whep_a1b2c3 \
  -H "Authorization: Bearer gid_YOUR_API_KEY"