Skip to main content
DELETE
/
webhooks
/
{id}
curl -X DELETE https://teambattles.gg/api/v1/webhooks/wh_abc123 \
  -H "Authorization: Bearer tb_your_api_key"

{
  "ok": true
}

​
Permission Required

This endpoint requires the webhooks.manage permission (the { kind: "webhook" } scope) on your API key, plus the webhooks feature. Webhooks are gated to api_pro or higher plans: a key on a free plan receives 403 error_api_feature_required.

​
Access / Membership Rules

Webhooks are owner-scoped. The {id} must resolve to an endpoint in your key’s own derived scope (user, game, or league, depending on your key type). An endpoint owned by another scope - or an unknown id - is reported as 404 error_webhook_not_found.

​
What’s Returned

Returns { "ok": true } on success. Deletion cascades the endpoint’s delivery logs and its rate-limit bucket; the endpoint stops receiving deliveries immediately.
This is irreversible. To temporarily stop deliveries instead, disable the endpoint with Update A Webhook Endpoint (isActive: false).
curl -X DELETE https://teambattles.gg/api/v1/webhooks/wh_abc123 \
  -H "Authorization: Bearer tb_your_api_key"

Authorizations

​
Authorization
string
header
required

Send your API key as: Authorization: Bearer tb_

Path Parameters

​
id
string
required

Webhook endpoint id.

Response

Deletion acknowledged.

Success ack.

​
ok
boolean
required