pause_webhook_endpoint
Stop deliveries to an endpoint without removing it. Events raised while paused are not queued for it.
The application's on/off switch for an endpoint. A paused endpoint keeps its secret, its event subscriptions and its delivery log; what stops is new deliveries. Use it during a consumer outage or a migration, then resume_webhook_endpoint.
Paused events are not replayed
Events raised while the endpoint is paused are not queued for it, so they
are gone for that endpoint when it resumes. If the consumer must see
everything, leave the endpoint on and let the retry ladder and
retry_dead_webhook_deliveries
carry it through the outage instead.
Only the person who registered the endpoint, or the team owner, may pause it; a fellow team member is refused with FORBIDDEN. Idempotent: an already-paused endpoint is a no-op.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Annotations
A client that honours annotations asks a person before running it. Sending the same arguments twice changes nothing the second time.
Arguments
endpoint_id*stringUUID of the webhook endpoint to pause.
What it returns
{ "data": { "id": "c62a08f4-1b7d-4e35-9860-a37f5d21e0b9", "name": "Delivery board", "url": "https://hooks.example.test/zusegenius", "project_id": null, "events": ["project.created", "project.status_changed"], "is_active": false, "disabled_at": "2026-10-26T09:20:00+00:00", "allowed_ips": [], "failure_count": 2, "consecutive_failures": 0, "last_success_at": "2026-10-25T18:00:00+00:00", "last_failure_at": "2026-10-20T07:12:00+00:00", "created_at": "2026-10-01T10:05:00+00:00", "updated_at": "2026-10-26T09:20:00+00:00" }, "meta": {}}How it fails
FORBIDDENthe token belongs to a team member who did not register the endpoint and is not the team owner.
RESOURCE_NOT_FOUNDunknown endpoint_id, or an endpoint of another team.
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks webhook-endpoint:update.
How is this guide?
Last updated on