Revoke a webhook
Permanently revoke a user-owned webhook while preserving its durable delivery history.
API 2.7.0 · Published service contract ↗
Request
Base URL: https://app.sym.so/v1/workspaces/{workspace_id}
Authentication: bearer. Required scope: webhooks:write.
DELETE /webhooks/{webhook_id}
Permanently revoke a user-owned webhook while preserving its durable delivery history.
| Parameter | Type | Description |
|---|---|---|
webhook_idpath · required | string | User-owned webhook ID. |
curl --fail-with-body -X DELETE "https://app.sym.so/v1/workspaces/$WORKSPACE_ID/webhooks/$WEBHOOK_ID" \
-H "Authorization: Bearer $SYM_WORKSPACE_API_KEY"{
"worker_id": "worker-example-001",
"org_id": "workspace_example",
"item": {
"id": "wh_01J8",
"name": "Production events",
"url": "https://example.com/symposium",
"events": [
"message.completed"
],
"status": "revoked",
"revoked_at": "2026-08-05T08:33:00Z"
},
"revoked": true,
"ok": true
}Authorization
{
"type": "bearer",
"scope": "webhooks:write",
"transport": "Authorization: Bearer <workspace_api_key>"
}Errors
| Status | Description |
|---|---|
| 401 | The workspace API key is missing, invalid, expired, or revoked. |
| 403 | The key lacks the required scope or its owner no longer has permission. |
| 404 | The resource is missing or intentionally hidden by authorization. |
| 429 | The key exceeded its current rate limit. |