SeatBuilderSeatBuilder Docs
Webhooks

Delete a webhook endpoint

Deletes a webhook endpoint. In-flight deliveries (queued retries) are cancelled. Past delivery records are kept for 30 days and remain queryable via `/deliveries`.

DELETE/api/v1/webhooks/{id}

Path Parameters

idstring

Response Body

curl -X DELETE "http://localhost:3000/api/v1/webhooks/string"

{
  "id": "wh_2a8f1d",
  "deleted": true
}
{
  "statusCode": 0,
  "message": "string",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}
{
  "statusCode": 0,
  "message": "string",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}
{
  "statusCode": 0,
  "message": "string",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}

Update a webhook endpoint PATCH

Updates a webhook endpoint's `url`, `events`, `enabled`, or `description`. The `events` array REPLACES the current subscription list (not merged). At least one field is required.

Rotate a webhook signing secret POST

Generates a new HMAC-SHA256 signing secret and returns it ONCE. Update your verification code with the new secret before the next delivery — the old secret is invalidated immediately. Use this after a suspected secret leak or as part of routine rotation.