Skip to main content
PATCH
curl
Use this endpoint to change where a destination sends webhooks and which events it receives.

Updating subscribed_events

When you send subscribed_events, provide the complete event list that should remain subscribed after the update. The array replaces the previous subscription set.
Supported values are: Use the create destination guide for detailed event descriptions and common subscription sets.

Authorizations

x-api-key
string
header
required

Path Parameters

destination_uuid
string<uuid>
required

UUID of the destination to update.

Body

application/json
label
string

New human-readable name.

url
string<uri>

New target URL. Must be unique within the application.

enabled
boolean

Set to false to pause deliveries to this destination without deleting it.

webhook_version
enum<string>

New payload schema version for future deliveries.

Available options:
v1,
v2,
v3
subscribed_events
enum<string>[]

Event filter for this webhook destination. Didit delivers only webhooks whose event type exactly matches one of these values — there is no wildcard subscription. When sent, the list must contain at least one valid event (an explicit [] is rejected with 400); a destination whose list is empty (field omitted at create) receives nothing. On update the list is replaced wholesale, never merged.

Minimum array length: 1

Supported webhook event name. Use these exact strings in subscribed_events; unsupported values are rejected.

Available options:
status.updated,
data.updated,
user.status.updated,
user.data.updated,
business.status.updated,
business.data.updated,
activity.created,
transaction.created,
transaction.status.updated,
travel_rule.status.updated
Example:

Response

Updated webhook destination. Body has the same shape as GET /v3/webhook/destinations/{destination_uuid}/.

uuid
string<uuid>
label
string
url
string<uri>
enabled
boolean
webhook_version
enum<string>
Available options:
v1,
v2,
v3
secret_shared_key
string
subscribed_events
enum<string>[]

Event filter for this webhook destination. Didit delivers only webhooks whose event type exactly matches one of these values — there is no wildcard subscription. When sent, the list must contain at least one valid event (an explicit [] is rejected with 400); a destination whose list is empty (field omitted at create) receives nothing. On update the list is replaced wholesale, never merged.

Minimum array length: 1

Supported webhook event name. Use these exact strings in subscribed_events; unsupported values are rejected.

Available options:
status.updated,
data.updated,
user.status.updated,
user.data.updated,
business.status.updated,
business.data.updated,
activity.created,
transaction.created,
transaction.status.updated,
travel_rule.status.updated
Example:
created_at
string<date-time>
updated_at
string<date-time>
summary
object