BRbrale
Webhooks

Update webhook subscription

Changed on

Updates URL and/or subscribed event types for an active subscription. When events is sent, it replaces the full set. Archived subscriptions return 409.

patch/accounts/{account_id}/webhooks/subscriptions/{subscription_id}

Request

  • Base URL
    https://api.brale.xyz
  • Auth
    OAuth 2
    Client credentials
    Token URL: https://auth.brale.xyz/oauth2/token scopes: webhooks:write, webhooks:read

Path parameters

account_idstring required

ID of the resource

Example:2VZvtmVc2j3gQ80CTlcuQXbGrwC

Account ID

subscription_idstring required

ID of the resource

Example:2VZvtmVc2j3gQ80CTlcuQXbGrwC

Webhook subscription ID

Request body

eventsstring[] nullable

When present, replaces all subscribed event types. Supports concrete types (e.g. transfer.created) and namespace wildcards (e.g. transfer.*).

urlstring nullable

HTTPS URL to receive signed webhook POST requests

Response

OK

eventsstring[] required
idstring required

ID of the resource

status'active' | 'archived' required

Subscription lifecycle: active deliveries or archived (no longer used).

urlstring required

Example response

{
  "id": "2VZvtmVc2j3gQ80CTlcuQXbGrwC"
}

Changes

  • d934fd29acc3Revision changes
    • breaking

      media type application/vnd.api+json was changed to a more general media type application/json for the response status

    • breaking

      media type application/vnd.api+json was changed to a more general media type application/json for the response status

    • breaking

      media type application/vnd.api+json was changed to a more general media type application/json for the response status

    • breaking

      media type application/vnd.api+json was changed to a more general media type application/json for the response status

    • breaking

      media type application/vnd.api+json was changed to a more general media type application/json for the response status

    • breaking

      media type application/vnd.api+json was changed to a more general media type application/json for the response status

  • 0f6e2639fbe2Revision changes
    • info

      endpoint added