resume_webhook_endpoint

Start deliveries to a paused endpoint again and clear its failure streak. Events raised while paused are not replayed.

Purpose

The reverse of pause_webhook_endpoint, and also the way to bring back an endpoint the failure streak disabled. Resuming clears the consecutive-failure count, so a target that was fixed while paused is not disabled again on its first miss.

Nothing is replayed on resume

Events raised while the endpoint was paused were never queued for it and are not sent now. Rows that dead-lettered before the pause are a different matter: replay those with retry_dead_webhook_deliveries once the consumer is healthy.

Only the creator who registered the endpoint, or the team owner, may resume it; a fellow team member is refused with FORBIDDEN. Idempotent: an already-active endpoint is a no-op.

Required ability

webhook-endpoint:update

Input schema

{
  "type": "object",
  "required": ["endpoint_id"],
  "properties": {
    "endpoint_id": {
      "type": "string",
      "description": "UUID of the webhook endpoint to resume."
    }
  }
}

Output shape

{
  "data": {
    "id": "c62a08f4-1b7d-4e35-9860-a37f5d21e0b9",
    "name": "CRM sync",
    "url": "https://hooks.example.com/subscriby",
    "project_id": null,
    "events": ["subscription.created", "subscription.cancelled"],
    "is_active": true,
    "disabled_at": null,
    "allowed_ips": [],
    "failure_count": 2,
    "consecutive_failures": 0,
    "last_success_at": "2026-09-05T18:00:00+00:00",
    "last_failure_at": "2026-08-30T07:12:00+00:00",
    "created_at": "2026-05-18T10:05:00+00:00"
  }
}

Example prompts

"Resume webhook endpoint c62a08f4-1b7d-4e35-9860-a37f5d21e0b9 — the CRM migration is done."

"Turn the finance webhook back on and replay whatever dead-lettered since Friday."

"The consumer is fixed; re-enable the endpoint the failure streak disabled."

Failure modes

FORBIDDEN — the token belongs to a team member who did not register the endpoint and is not the team owner.
VALIDATION_FAILED — the resume was refused for the endpoint's current state.
RESOURCE_NOT_FOUND — unknown endpoint_id, or an endpoint of another team.
AUTHENTICATION_REQUIRED — no authenticated user on the request.
TOKEN_MISSING_ABILITY — token lacks webhook-endpoint:update.

pause_webhook_endpoint — the reverse.
retry_dead_webhook_deliveries — replay what dead-lettered before the pause.
Webhook endpoints API — the REST equivalent.