Home API Reference VaultsUpdate Webhook Events

PATCH/vaults/update-webhook-events/{id}

Update Webhook Events

Outcome - Updates existing webhook events configuration for a specific vault.

Path Parameters

idnumber

The ID of the webhook

Body Parameters

eventsobjectrequired

Object containing arrays of event names grouped by category to update

Responses

Response attributes

messagestring

Success message

dataobject

Updated webhook and event details

Show child attributes (8)

idnumber

Webhook ID

urlstring

Webhook URL

retryCountnumber

Number of retries

vaultIdnumber

Vault ID

retryPeriodstring

Retry period

eventsobject

Updated events subscription status

subscribed_events_countnumber

Total number of subscribed events

eventsDescriptionobject

Description of available events

statusnumber

HTTP status code

Was this page helpful?

PreviousCreate Webhook Events NextCreate Transaction

Base URL

Production

https://YOUR-SUBDOMAIN.api.roxcustody.com/api/integration

Sandbox

https://YOUR-SUBDOMAIN.api-sandbox.roxcustody.com/api/integration

Language Box

PATCH/vaults/update-webhook-events/{id}

1	curl --request PATCH \
2	--url 'https://YOUR-SUBDOMAIN.api.roxcustody.com/api/integration/vaults/update-webhook-events/{id}' \
3	--header 'Content-Type: application/json' \
4	--header 'X-ACCESS-TOKEN: YOUR-ACCESS-TOKEN' \
5	--data '{
6	"events": {
7	"assets": [
8	"hold_asset"
9	],
10	"networks": [
11	"hold_network"
12	]
13	}
14	}'

Response

Webhook event updated successfully

{

"message": "Webhook event updated successfully",

"data": {

"id": 1,

"url": "https://miya-aurorean-incidentally.ngrok-free.dev/webhook",

"retryCount": 5,

"vaultId": 12,

"retryPeriod": "15-minute",

"events": {

"transactions": {

"create_transaction": {

"retryCount": 5,

"retryPeriod": "15-minute",

"subscribed": false

"broadcasted_transaction": {

"retryCount": 5,

"retryPeriod": "15-minute",

"subscribed": false

"rejected_transaction": {

"retryCount": 5,

"retryPeriod": "15-minute",

"subscribed": false

"error_transaction": {

"retryCount": 5,

"retryPeriod": "15-minute",

"subscribed": false

"blockchain_rejected_transaction": {

"retryCount": 5,

"retryPeriod": "15-minute",

"subscribed": false

"completed_transaction": {

"retryCount": 5,

"retryPeriod": "15-minute",

"subscribed": false

"compliance_rule_transaction": {

"retryCount": 5,

"retryPeriod": "15-minute",

"subscribed": false

"cancel_transaction": {

"retryCount": 5,

"retryPeriod": "15-minute",

"subscribed": false

}

"vault": {

"sync_vault_wallets": {

"retryCount": 5,

"retryPeriod": "15-minute",

"subscribed": false

"sync_client_wallets": {

"retryCount": 5,

"retryPeriod": "15-minute",

"subscribed": false

}

"assets": {

"add_asset": {

"retryCount": 5,

"retryPeriod": "15-minute",

"subscribed": false

"activate_asset": {

"retryCount": 5,

"retryPeriod": "15-minute",

"subscribed": false

"deactivate_asset": {

"retryCount": 5,

"retryPeriod": "15-minute",

"subscribed": false

"hold_asset": {

"retryCount": 5,

"retryPeriod": "15-minute",

"subscribed": true

}

"networks": {

"hold_network": {

"retryCount": 5,

"retryPeriod": "15-minute",

"subscribed": true

}

"tokens": {

"token_created_with_asset": {

"retryCount": 5,

"retryPeriod": "15-minute",

"subscribed": false

}

"paymentVaultOrder": {

"create_payment_vault_order": {

"retryCount": 5,

"retryPeriod": "15-minute",

"subscribed": false

"select_asset_payment_vault_order": {

"retryCount": 5,

"retryPeriod": "15-minute",

"subscribed": false

"cancelled_payment_vault_order": {

"retryCount": 5,

"retryPeriod": "15-minute",

"subscribed": false

"paid_payment_vault_order": {

"retryCount": 5,

"retryPeriod": "15-minute",

"subscribed": false

}

"subscribed_events_count": 2,

"eventsDescription": {

"create_transaction": "Fires when a new transaction is created.",

"compliance_rule_transaction": "Fires when a new compliance rule transaction is created",

"broadcasted_transaction": "Fires when a transaction is being broadcast to the blockchain network.",

"rejected_transaction": "Fires when a transaction is rejected by the admin.",

"cancel_transaction": "Fires when a transaction is cancelled.",

"error_transaction": "Fires when an unexpected error occurs during transaction processing.",

"blockchain_rejected_transaction": "Fires when a transaction is rejected by the blockchain network.",

"completed_transaction": "Fires when a transaction is confirmed and successfully completed.",

"sync_vault_wallets": "Fires when vault wallets are synchronized with the system.",

"sync_client_wallets": "Fires when client wallets are synchronized with the system.",

"add_asset": "Fires when a new asset is added to a vault.",

"activate_asset": "Fires when an asset is activated and made available for use.",

"deactivate_asset": "Fires when an asset is deactivated and becomes unavailable.",

"hold_asset": "Fires when an asset is placed on hold or reactivated by a corporate admin or Roxcustody super admin.",

"hold_network": "Fires when a blockchain network is placed on hold or reactivated by a corporate admin or Roxcustody super admin.",

"token_created_with_asset": "Fires when a new security token is created.",

"create_payment_vault_order": "Fires when a new payment vault order is created.",

"select_asset_payment_vault_order": "Fires when an asset is selected for a payment vault order.",

"cancelled_payment_vault_order": "Fires when a payment vault order is cancelled.",

"paid_payment_vault_order": "Fires when a payment vault order is marked as paid."

}

"status": 200

}