curl --request PATCH \
--url https://api.platform.dakota.xyz/recipients/{recipient_id}/destinations/{destination_id} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"assets": [
"USD",
"EUR"
]
}
'const options = {
method: 'PATCH',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({assets: ['USD', 'EUR']})
};
fetch('https://api.platform.dakota.xyz/recipients/{recipient_id}/destinations/{destination_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.platform.dakota.xyz/recipients/{recipient_id}/destinations/{destination_id}"
payload = { "assets": ["USD", "EUR"] }
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.platform.dakota.xyz/recipients/{recipient_id}/destinations/{destination_id}"
payload := strings.NewReader("{\n \"assets\": [\n \"USD\",\n \"EUR\"\n ]\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"destination_type": "fiat_iban",
"destination_id": "2zQ5Xv1b8kYc3Hq9LrT7NwPdE4m",
"recipient_id": "2zQ5Xv1b8kYc3Hq9LrT7NwPdE4n",
"name": "International Business Account",
"iban": "DE89370400440532013000",
"bic": "DEUTDEFFXXX",
"account_holder_name": "John Doe",
"bank_name": "Deutsche Bank",
"capabilities": [
"sepa",
"swift"
],
"assets": [
"USD",
"EUR"
]
}{
"type": "https://docs.dakota.xyz/api-reference/errors#invalid-request",
"title": "Invalid request",
"status": 400,
"detail": "Invalid request",
"instance": "https://api.platform.dakota.xyz/recipients/example-id/destinations/example-id",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#authentication-error",
"title": "Unauthorized",
"status": 401,
"detail": "Unauthorized",
"instance": "https://api.platform.dakota.xyz/recipients/example-id/destinations/example-id",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#forbidden",
"title": "Forbidden",
"status": 403,
"detail": "Forbidden",
"instance": "https://api.platform.dakota.xyz/recipients/example-id/destinations/example-id",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Not found",
"status": 404,
"detail": "Not found",
"instance": "https://api.platform.dakota.xyz/recipients/example-id/destinations/example-id",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}Update a destination's supported currencies
Replaces the list of currencies a saved bank destination is recorded as
supporting. Only assets can be changed; every other field of a
destination is fixed at creation.
Dakota does not check this list when a payment is created, so a payment in a currency missing from it is not blocked; the dashboard warns instead. USD is always kept first when listed, because a provider that registers a single currency for the account uses the first one. Every code must be a registered currency. Currencies other than USD are accepted only on destinations that support SWIFT.
curl --request PATCH \
--url https://api.platform.dakota.xyz/recipients/{recipient_id}/destinations/{destination_id} \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"assets": [
"USD",
"EUR"
]
}
'const options = {
method: 'PATCH',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({assets: ['USD', 'EUR']})
};
fetch('https://api.platform.dakota.xyz/recipients/{recipient_id}/destinations/{destination_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.platform.dakota.xyz/recipients/{recipient_id}/destinations/{destination_id}"
payload = { "assets": ["USD", "EUR"] }
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.platform.dakota.xyz/recipients/{recipient_id}/destinations/{destination_id}"
payload := strings.NewReader("{\n \"assets\": [\n \"USD\",\n \"EUR\"\n ]\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"destination_type": "fiat_iban",
"destination_id": "2zQ5Xv1b8kYc3Hq9LrT7NwPdE4m",
"recipient_id": "2zQ5Xv1b8kYc3Hq9LrT7NwPdE4n",
"name": "International Business Account",
"iban": "DE89370400440532013000",
"bic": "DEUTDEFFXXX",
"account_holder_name": "John Doe",
"bank_name": "Deutsche Bank",
"capabilities": [
"sepa",
"swift"
],
"assets": [
"USD",
"EUR"
]
}{
"type": "https://docs.dakota.xyz/api-reference/errors#invalid-request",
"title": "Invalid request",
"status": 400,
"detail": "Invalid request",
"instance": "https://api.platform.dakota.xyz/recipients/example-id/destinations/example-id",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#authentication-error",
"title": "Unauthorized",
"status": 401,
"detail": "Unauthorized",
"instance": "https://api.platform.dakota.xyz/recipients/example-id/destinations/example-id",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#forbidden",
"title": "Forbidden",
"status": 403,
"detail": "Forbidden",
"instance": "https://api.platform.dakota.xyz/recipients/example-id/destinations/example-id",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}{
"type": "https://docs.dakota.xyz/api-reference/errors#not-found",
"title": "Not found",
"status": 404,
"detail": "Not found",
"instance": "https://api.platform.dakota.xyz/recipients/example-id/destinations/example-id",
"request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}Authorizations
Path Parameters
KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.
27^[0-9A-Za-z]{27}$"1NFHrqBHb3cTfLVkFSGmHZqdDPi"
KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.
27^[0-9A-Za-z]{27}$"1NFHrqBHb3cTfLVkFSGmHZqdDPi"
Body
Replaces a bank destination's supported currencies.
The complete list of currencies the destination supports. It replaces the stored list.
1^[A-Z]{3}$["USD", "EUR"]
Response
Destination updated successfully.
- Crypto Destination Response
- Crypto Destination Response
- Crypto Destination Response
- US Fiat Destination Response
- IBAN Fiat Destination Response
Response for a crypto destination.
KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.
27^[0-9A-Za-z]{27}$"1NFHrqBHb3cTfLVkFSGmHZqdDPi"
The type of destination.
crypto Name of the destination for reference
"My Ethereum Wallet"
Wallet address for the crypto account.
"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
Blockchain family for the crypto account.
evm, solana "evm"
Identifier for a blockchain network
ethereum-mainnet, ethereum-sepolia, ethereum-goerli, ethereum-holesky, solana-mainnet, solana-devnet, solana-testnet, base-mainnet, base-sepolia, arbitrum-mainnet, arbitrum-sepolia, optimism-mainnet, optimism-sepolia, polygon-mainnet, polygon-amoy 1 - 30"ethereum-mainnet"
Was this page helpful?

