Skip to main content
PATCH
Update a webhook subscription

Autorizaciones

Authorization
string
header
requerido

Clave API enviada como token Bearer

Parámetros de ruta

webhook_id
string
requerido

Cuerpo

application/json
url
string<uri> | null
Required string length: 1 - 2083
name
string | null

Optional label. Send a non-empty value to set/replace it, or an empty string to clear it. Omit to leave it unchanged.

Maximum string length: 100
events
enum<string>[] | null

Replace the subscribed event types (at least one). Preferred over event.

Webhook event types exposed to API clients.

Mirrors SynapseWebhookEventType enum in datalayer (camelCase) but rendered to clients as snake_case dotted strings (closer to Stripe convention and easier to grep in caller logs).

Opciones disponibles:
scribe_session.created,
scribe_session.completed,
scribe_session.error,
scribe_session.updated,
scribe_session.cancelled,
scribe_session.deleted
event
enum<string> | null
obsoleto

Deprecated: a single event type. Use events. When set and events is omitted, it replaces the subscription with a one-element list.

Opciones disponibles:
scribe_session.created,
scribe_session.completed,
scribe_session.error,
scribe_session.updated,
scribe_session.cancelled,
scribe_session.deleted
isActive
boolean | null

Pause/resume delivery without deleting the subscription.

Respuesta

Respuesta exitosa

A single webhook subscription.

id
string
requerido
url
string
requerido
events
enum<string>[]
requerido

Webhook event types exposed to API clients.

Mirrors SynapseWebhookEventType enum in datalayer (camelCase) but rendered to clients as snake_case dotted strings (closer to Stripe convention and easier to grep in caller logs).

Opciones disponibles:
scribe_session.created,
scribe_session.completed,
scribe_session.error,
scribe_session.updated,
scribe_session.cancelled,
scribe_session.deleted
isActive
boolean
requerido
name
string | null

Optional human-readable label, or null if unset.

event
enum<string> | null
obsoleto

Deprecated: the first subscribed event (events[0]). Use events.

Opciones disponibles:
scribe_session.created,
scribe_session.completed,
scribe_session.error,
scribe_session.updated,
scribe_session.cancelled,
scribe_session.deleted
signingSecretPrefix
string | null

Display hint for the signing secret (e.g. 'whsec_a1b2c3d4'). The raw secret is only returned at creation/rotation.

signingSecretVersion
integer | null
createdAt
string | null
updatedAt
string | null
deletedAt
string | null