---
title: "Update webhook endpoint"
method: PATCH
path: "/v1/webhooks/endpoints/{endpointId}"
tags: ["Webhooks"]
---

# Update webhook endpoint

`PATCH /v1/webhooks/endpoints/{endpointId}`

Update a webhook endpoint. Change its URL, replace the event types it is subscribed to, update its description, or pause and resume delivery. Only the fields you provide are changed. Updating webhooks is free.

<span>⚡ <strong>Rate limit:</strong> 60 requests per 1 minute</span>

<span>💰 <strong>Cost:</strong> FREE! No credits are charged for this API.&nbsp;<span title="Pricing shown is default pricing. Actual pricing may vary.">ⓘ</span></span>

## Path parameters

- `endpointId` string, required

## Request body

- object
  - `apiKey` string, required — Your Fiber API key
  - `url` string, uri, nullable — A new HTTPS URL to receive event payloads.
  - `eventTypes` string[], nullable — A new set of event types to subscribe this endpoint to.
  - `description` string, nullable — A new human-readable label for this endpoint.
  - `disabled` boolean, nullable — Set to true to pause delivery, or false to resume it.

## Response `200`

Default Response

- object
  - `output` object, required
    - `endpointId` string, required — The unique ID of this webhook endpoint.
    - `url` string, required — The HTTPS URL that receives event payloads.
    - `eventTypes` string[], required — The event types this endpoint is subscribed to. An empty array means the endpoint receives every event type; endpoints created through this API are always subscribed to one or more specific event types.
    - `description` string, nullable — An optional human-readable label for this endpoint.
    - `disabled` boolean, required — Whether delivery to this endpoint is currently paused.
    - `createdAt` string, required — When the endpoint was created (ISO 8601).
    - `updatedAt` string, required — When the endpoint was last updated (ISO 8601).
  - `chargeInfo` union, required
    - object — Credits were charged immediately for this operation
      - `method` 'charged-now', required
      - `creditsCharged` number, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits will be charged after the operation completes
      - `method` 'charging-later', required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits that were charged for an asynchronous operation
      - `method` 'charged-for-async-process', required
      - `creditsCharged` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — No credits were charged for this operation
      - `method` 'free', required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
    - object — Credits were refunded for this operation
      - `method` 'credits-refunded', required
      - `creditsRefunded` number, required
      - `message` string, required
      - `lowCreditAlert` object, nullable — Contains a link to get more credits, a warning message, and the remaining credit count.
        - `getMoreCreditsUrl` string, uri, required — URL to top up credits or restart billing cycle to get fresh credits.
        - `message` string, required — Human-readable credits warning.
        - `availableCredits` number, required — Number of credits remaining in the current billing period.
  - `warnings` object[], nullable — Warnings about extraneous fields in request
    - `field` string, required — Full path to extraneous field (e.g., 'searchParams.ExtraField')
    - `message` string, required — Warning message
  - `advice` string[], nullable — Tips, recommendations, and suggestions for using this API effectively.

## Other responses

- `400` — Default Response
- `401` — Default Response
- `402` — Default Response
- `403` — Default Response
- `404` — Default Response
- `422` — Default Response
- `429` — Default Response
- `500` — Default Response
- `503` — Default Response

---

[API](https://skmtc.net/fiber/apis/fiber-ai-api.md) · [All operations](https://skmtc.net/fiber/apis/fiber-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fiber/fiber-ai-api/versions/693a454797a3/schema)