Configuration Approval Callback
POST /v2/config_change_sign_request
This request expects a CallbackResponse object from the callback handler. If the callback handler does not respond within 30 seconds, Fireblocks fails the request.
Request parameters
| Parameter | Type | Description |
|---|---|---|
| requestId | string | A unique identifier of this request. It must be returned in the response. |
| type | string | The type of configuration request:UNMANAGED_WALLET, EXCHANGE, FIAT_ACCOUNT, ADD_USER, RE_ENROLL_DEVICE, ENABLE_ONE_TIME_ADDRESS, CHANGE_QUORUM_THRESHOLD, ADD_NETWORK_CONNECTION, SET_NETWORK_CONNECTION_ROUTING_POLICY, SET_NETWORK_ID_POLICY |
| extraInfo | object | Additional information about the request, depending on the type: For UNMANAGED_WALLET, this is an AddressInfo object.For EXCHANGE or FIAT_ACCOUNT, this is a ThirdPartyInfo object. |
Data objects
AddressInfo
The AddressInfo object contains additional information for whitelisting a destination address.
| Parameter | Type | Description |
|---|---|---|
| subType | string | INTERNAL - Internal Wallets are addresses that you control outside of your Fireblocks workspace. Internal addresses display their current balance and are included in your workspace's total billable address count.EXTERNAL - External Wallets are addresses managed by your clients and counterparties.CONTRACT - Contract Wallets are addresses of smart contracts that you want to interact with. Currently, this only applies to smart contracts on EVM-compatible blockchains. |
| walletName | string | The name of the internal, external, or contract wallet that you want to approve adding an address to. |
| walletId | object | The ID of the internal, external, or contract wallet that you want to approve adding an address to. |
| asset | string | The ID of the asset to add to this wallet. Use GET supported assets request to retrieve more information about an asset. |
| address | string | The asset deposit address requested to add to the wallet. |
| tag | string | Destination address tag for Ripple; destination memo for EOS, Stellar, Hedera, & DigitalBits; destination note for Algorand; bank transfer description for fiat providers. Note: For Stellar, the memo must be a string representation of an integer between “0” and “2147483647”. Setting the memo to other values for Stellar assets will result in a failed request with an error message. |
ThirdPartyInfo
| Parameter | Type | Description |
|---|---|---|
| subType | string | The exchange account, fiat account, or unmanaged wallet (INTERNAL, EXTERNAL). |
| accountName | string | The account's name. |
| accountId | string | The account's ID. |
| apiKey | string | The third-party service's API key. |
| addresses | string | (Optional) A JSON-formatted "key":"value" string, where "key" is an asset symbol and "value" is its address. There can be multiple entries in the JSON. Use supported_assets to retrieve asset symbols. |
AddNetworkConnection
| Parameter | Type | Description |
|---|---|---|
| networkConnectionId | string | ID of network connection |
| note | string | Connection note |
| localNetworkID | string | ID of local networkId |
| remoteTenantID | string | ID of remote peer tenantId |
| routingPolicy | string | JSON representation of routing policy object |
NetworkConnectionRoutingPolicy
| Parameter | Type | Description |
|---|---|---|
| connectionId | string | ID of network connection |
| routingPolicy | string | JSON representation of routing policy object |
NetworkIdRoutingPolicy
| Parameter | Type | Description |
|---|---|---|
| networkID | string | ID of networkID |
| routingPolicy | string | JSON representation of routing policy object |