---
title: "PATCH /webhook/{webhookId}"
method: PATCH
path: "/webhook/{webhookId}"
---

# PATCH /webhook/{webhookId}

`PATCH /webhook/{webhookId}`

Update a webhook endpoint status.

**Status transitions:**
- `active`: Re-enables the endpoint. Use this to:
  - Unpause a paused endpoint
  - Re-enable an endpoint that is backing-off or disabled due to delivery failures
  - When re-enabled, any queued notifications will be sent
- `paused`: Pauses the endpoint. While paused:
  - New notifications are queued (not lost)
  - No delivery attempts are made
  - Use `active` to resume and process queued notifications
- `archived`: Permanently archives the endpoint (soft delete)

**Note:** The `backing-off` and `disabled` statuses are system-managed and cannot be set directly.
These occur automatically when delivery failures are detected. Use `active` to re-enable.

## Path parameters

- `webhookId` string, required

## Request body

- object
  - `status` 'active' | 'paused' | 'archived', required — The desired status for the endpoint: - `active`: Enable/re-enable the endpoint - `paused`: Pause the endpoint (notifications are queued) - `archived`: Archive the endpoint (soft delete)
  - `reason` string — Optional reason for the status change (for audit purposes)

## Response `200`

OK

- Webhook
  - `id` string, required
  - `createdAt` string, required
  - `archivedAt` string
  - `url` string, required — The URL that will receive the webhook payload
  - `name` string, required — The name of the webhook
  - `status` 'active' | 'paused' | 'backing-off' | 'disabled', required — The current status of the webhook endpoint: - `active`: The webhook is enabled and receiving events normally. - `paused`: The webhook has been paused by the user. Events are queued and will be delivered when the endpoint is set back to `active`. - `backing-off`: The system is temporarily backing off due to delivery failures. Delivery will be automatically retried at `backingOffUntil`. You can also immediately re-enable by setting status to `active` via the PATCH endpoint. - `disabled`: The webhook has been automatically disabled due to repeated delivery failures. Re-enable by setting status to `active` via the PATCH endpoint.
  - `pausedAt` string — When the endpoint was paused by the user (ISO 8601 timestamp)
  - `backingOffUntil` string — When the system will automatically retry delivery (ISO 8601 timestamp). Only present when status is `backing-off`.
  - `disabledAt` string — When the endpoint was automatically disabled due to repeated failures (ISO 8601 timestamp). Only present when status is `disabled`.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `429` — TooManyRequests
- `500` — Internal Error

---

[API](https://skmtc.net/slashfi/apis/slash-public-api.md) · [All operations](https://skmtc.net/slashfi/apis/slash-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/slashfi/slash-public-api/versions/773c90f079c5/schema)