SymDocs
Workspace API
All productsSym Workspace APISym Passes MCP
Supportjoinsym.com ↗
Sym Workspace API

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.

ParameterTypeDescription
webhook_id
path · required
stringUser-owned webhook ID.
Request
curl --fail-with-body -X DELETE "https://app.sym.so/v1/workspaces/$WORKSPACE_ID/webhooks/$WEBHOOK_ID" \
  -H "Authorization: Bearer $SYM_WORKSPACE_API_KEY"
Response 200
{
  "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

Credential contract
{
  "type": "bearer",
  "scope": "webhooks:write",
  "transport": "Authorization: Bearer <workspace_api_key>"
}

Errors

StatusDescription
401The workspace API key is missing, invalid, expired, or revoked.
403The key lacks the required scope or its owner no longer has permission.
404The resource is missing or intentionally hidden by authorization.
429The key exceeded its current rate limit.