Sign in
Management

Update webhook

Changed on

Update one webhook by webhookId for a project. Send only fields you want to change; omitted fields stay unchanged. Returns 404 if the project or webhook does not exist and 422 for validation errors. This endpoint requires the write:all scope.

post/management/projects/{projectId}/webhooks/{webhookId}

Request

  • Base URL: https://api.liveblocks.io/v2
  • URL: https://api.liveblocks.io/v2/management/projects/{projectId}/webhooks/{webhookId}
  • Auth: none declared

Path parameters

projectIdstring required

ID of the project

Example:683d49ed6b4d1cec5a597b13
webhookIdstring required

ID of the webhook

Example:wh_abc123

Request body

urlstring uri
subscribedEventsManagementWebhookEvent[]
rateLimitinteger
storageUpdatedThrottleSecondsinteger
yDocUpdatedThrottleSecondsinteger
disabledboolean

Example request

{
  "url": "https://example.com/webhooks",
  "subscribedEvents": [
    "storageUpdated",
    "userEntered"
  ],
  "rateLimit": 100,
  "disabled": false
}

Response

Success. Returns the updated webhook.

idstring required
createdAtstring date-time required
updatedAtstring date-time required
urlstring uri required
disabledboolean required
rateLimitinteger
subscribedEventsManagementWebhookEvent[] required
additionalHeadersManagementWebhookAdditionalHeaders
storageUpdatedThrottleSecondsinteger required
yDocUpdatedThrottleSecondsinteger required

Example response

{
  "id": "wh_abc123",
  "createdAt": "2024-09-03T12:34:56.000Z",
  "updatedAt": "2024-09-03T12:34:56.000Z",
  "url": "https://example.com/webhooks",
  "disabled": false,
  "subscribedEvents": [
    "storageUpdated",
    "userEntered"
  ],
  "secret": {
    "value": "whsec_abc123"
  },
  "storageUpdatedThrottleSeconds": 10,
  "yDocUpdatedThrottleSeconds": 10
}

Changes

  • 77cd6a75b2b7Revision changes
    • breaking

      request body became required

    • breaking

      the request property type changed from number to integer

    • breaking

      the request property type changed from number to integer

    • breaking

      the request property type changed from number to integer

    • breaking

      removed the required property from the response with the status

    • info

      api operation id post-management-webhook removed and replaced with update-management-webhook

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • acf80ed810c3Revision changes
    • info

      endpoint added