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 or SEPA.
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"
}Path Parameters
Body
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.
Your own label for this destination in your system, used to look it up with the external_id filter on GET /recipients/{recipient_id}/destinations. Not unique: Dakota does not reject a duplicate, and several destinations can share one value. Omitted when none was set.
"dest-1177-usd"
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?

