Update an account

curl --request PATCH \
  --url https://api.platform.dakota.xyz/accounts/{account_id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-idempotency-key: <x-idempotency-key>' \
  --data '
{
  "account_type": "onramp",
  "crypto_destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "fiat_destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "destination_network_id": "ethereum-mainnet",
  "destination_asset": "USDC"
}
'

const options = {
  method: 'PATCH',
  headers: {
    'x-idempotency-key': '<x-idempotency-key>',
    'x-api-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    account_type: 'onramp',
    crypto_destination_id: '1NFHrqBHb3cTfLVkFSGmHZqdDPi',
    fiat_destination_id: '1NFHrqBHb3cTfLVkFSGmHZqdDPi',
    destination_network_id: 'ethereum-mainnet',
    destination_asset: 'USDC'
  })
};

fetch('https://api.platform.dakota.xyz/accounts/{account_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.platform.dakota.xyz/accounts/{account_id}"

payload = {
    "account_type": "onramp",
    "crypto_destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
    "fiat_destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
    "destination_network_id": "ethereum-mainnet",
    "destination_asset": "USDC"
}
headers = {
    "x-idempotency-key": "<x-idempotency-key>",
    "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/accounts/{account_id}"

	payload := strings.NewReader("{\n  \"account_type\": \"onramp\",\n  \"crypto_destination_id\": \"1NFHrqBHb3cTfLVkFSGmHZqdDPi\",\n  \"fiat_destination_id\": \"1NFHrqBHb3cTfLVkFSGmHZqdDPi\",\n  \"destination_network_id\": \"ethereum-mainnet\",\n  \"destination_asset\": \"USDC\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("x-idempotency-key", "<x-idempotency-key>")
	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))

}

{
  "id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "account_type": "onramp",
  "bank_account": {
    "id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
    "capabilities": [
      "ach",
      "fedwire"
    ],
    "aba_routing_number": "123456789",
    "aba_wire_routing_number": "123456789",
    "account_number": "123456789",
    "account_type": "checking",
    "bic": "DEUTDEFFXXX",
    "iban": "DE89370400440532013000",
    "account_holder_name": "John Doe",
    "account_holder_address": {
      "street1": "123 Main St",
      "street2": "Apt 4B",
      "street3": "Building C",
      "city": "San Francisco",
      "region": "California",
      "postal_code": "94105",
      "country": "US"
    },
    "account_holder_phone": "1234567890",
    "bank_name": "Bank of America",
    "bank_address": {
      "street1": "123 Main St",
      "street2": "Apt 4B",
      "street3": "Building C",
      "city": "San Francisco",
      "region": "California",
      "postal_code": "94105",
      "country": "US"
    },
    "bank_phone": "+12345678900"
  },
  "destination": {
    "destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
    "destination_type": "crypto",
    "name": "My Ethereum Wallet",
    "crypto_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "family": "evm",
    "network_id": "ethereum-mainnet"
  },
  "source_crypto_address": "0x1234",
  "source_family": "evm",
  "source_network_id": "ethereum-mainnet",
  "source_asset": "USDC",
  "destination_asset": "USDC",
  "rail": "ach",
  "destination_rail": "ach"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#invalid-request",
  "title": "Invalid request",
  "status": 400,
  "detail": "Invalid request",
  "instance": "https://api.platform.dakota.xyz/accounts/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/accounts/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/accounts/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/accounts/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#conflict",
  "title": "Conflict",
  "status": 409,
  "detail": "Conflict",
  "instance": "https://api.platform.dakota.xyz/accounts/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#not-implemented",
  "title": "Not implemented",
  "status": 501,
  "detail": "Not implemented",
  "instance": "https://api.platform.dakota.xyz/accounts/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#provider-error",
  "title": "Provider error",
  "status": 502,
  "detail": "Provider error",
  "instance": "https://api.platform.dakota.xyz/accounts/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#internal-error",
  "title": "Service unavailable",
  "status": 503,
  "detail": "Service unavailable",
  "instance": "https://api.platform.dakota.xyz/accounts/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

Accounts

Update an account

Partially update an onramp, offramp, or swap account.

Only the account’s destination routing may be changed. For onramp accounts these are crypto_destination_id, destination_network_id, and destination_asset; for offramp accounts it is fiat_destination_id.

An account’s capabilities and rail are fixed when the account is created and cannot be changed through this endpoint. To use a different capability or rail, create a new account.

PATCH

accounts

{account_id}

Update an account

curl --request PATCH \
  --url https://api.platform.dakota.xyz/accounts/{account_id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --header 'x-idempotency-key: <x-idempotency-key>' \
  --data '
{
  "account_type": "onramp",
  "crypto_destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "fiat_destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "destination_network_id": "ethereum-mainnet",
  "destination_asset": "USDC"
}
'

const options = {
  method: 'PATCH',
  headers: {
    'x-idempotency-key': '<x-idempotency-key>',
    'x-api-key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    account_type: 'onramp',
    crypto_destination_id: '1NFHrqBHb3cTfLVkFSGmHZqdDPi',
    fiat_destination_id: '1NFHrqBHb3cTfLVkFSGmHZqdDPi',
    destination_network_id: 'ethereum-mainnet',
    destination_asset: 'USDC'
  })
};

fetch('https://api.platform.dakota.xyz/accounts/{account_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.platform.dakota.xyz/accounts/{account_id}"

payload = {
    "account_type": "onramp",
    "crypto_destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
    "fiat_destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
    "destination_network_id": "ethereum-mainnet",
    "destination_asset": "USDC"
}
headers = {
    "x-idempotency-key": "<x-idempotency-key>",
    "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/accounts/{account_id}"

	payload := strings.NewReader("{\n  \"account_type\": \"onramp\",\n  \"crypto_destination_id\": \"1NFHrqBHb3cTfLVkFSGmHZqdDPi\",\n  \"fiat_destination_id\": \"1NFHrqBHb3cTfLVkFSGmHZqdDPi\",\n  \"destination_network_id\": \"ethereum-mainnet\",\n  \"destination_asset\": \"USDC\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("x-idempotency-key", "<x-idempotency-key>")
	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))

}

{
  "id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
  "account_type": "onramp",
  "bank_account": {
    "id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
    "capabilities": [
      "ach",
      "fedwire"
    ],
    "aba_routing_number": "123456789",
    "aba_wire_routing_number": "123456789",
    "account_number": "123456789",
    "account_type": "checking",
    "bic": "DEUTDEFFXXX",
    "iban": "DE89370400440532013000",
    "account_holder_name": "John Doe",
    "account_holder_address": {
      "street1": "123 Main St",
      "street2": "Apt 4B",
      "street3": "Building C",
      "city": "San Francisco",
      "region": "California",
      "postal_code": "94105",
      "country": "US"
    },
    "account_holder_phone": "1234567890",
    "bank_name": "Bank of America",
    "bank_address": {
      "street1": "123 Main St",
      "street2": "Apt 4B",
      "street3": "Building C",
      "city": "San Francisco",
      "region": "California",
      "postal_code": "94105",
      "country": "US"
    },
    "bank_phone": "+12345678900"
  },
  "destination": {
    "destination_id": "1NFHrqBHb3cTfLVkFSGmHZqdDPi",
    "destination_type": "crypto",
    "name": "My Ethereum Wallet",
    "crypto_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "family": "evm",
    "network_id": "ethereum-mainnet"
  },
  "source_crypto_address": "0x1234",
  "source_family": "evm",
  "source_network_id": "ethereum-mainnet",
  "source_asset": "USDC",
  "destination_asset": "USDC",
  "rail": "ach",
  "destination_rail": "ach"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#invalid-request",
  "title": "Invalid request",
  "status": 400,
  "detail": "Invalid request",
  "instance": "https://api.platform.dakota.xyz/accounts/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/accounts/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/accounts/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/accounts/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#conflict",
  "title": "Conflict",
  "status": 409,
  "detail": "Conflict",
  "instance": "https://api.platform.dakota.xyz/accounts/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#not-implemented",
  "title": "Not implemented",
  "status": 501,
  "detail": "Not implemented",
  "instance": "https://api.platform.dakota.xyz/accounts/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#provider-error",
  "title": "Provider error",
  "status": 502,
  "detail": "Provider error",
  "instance": "https://api.platform.dakota.xyz/accounts/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#internal-error",
  "title": "Service unavailable",
  "status": 503,
  "detail": "Service unavailable",
  "instance": "https://api.platform.dakota.xyz/accounts/example-id",
  "request_id": "req_01hzy6y7v8w9x0y1z2a3b4c5d6"
}

Authorizations

x-api-key

string

header

required

Headers

x-idempotency-key

string<uuid>

required

Unique key to ensure request idempotency. If the same key is used within a certain time window, the original response will be returned instead of executing the request again.

Path Parameters

account_id

string

required

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.

Required string length: 27

Pattern: ^[0-9A-Za-z]{27}$

Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

Body

application/json

Unified account update request for onramp/offramp/swap.

Only destination routing fields are updatable: crypto_destination_id, destination_network_id, and destination_asset for onramp accounts, and fiat_destination_id for offramp accounts. capabilities and rail are immutable after account creation and cannot be updated through this request; create a new account to change them. developer_fee_bps is also updatable and applies to future transactions only; existing transactions are unaffected.

account_type

enum<string>

required

Unified account family for account resources.

Available options:

onramp,

offramp,

swap

Example:

"onramp"

crypto_destination_id

string

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.

Required string length: 27

Pattern: ^[0-9A-Za-z]{27}$

Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

fiat_destination_id

string

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.

Required string length: 27

Pattern: ^[0-9A-Za-z]{27}$

Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

destination_network_id

enum<string>

Identifier for a blockchain network

Available options:

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

Required string length: 1 - 30

Example:

"ethereum-mainnet"

destination_asset

string

Asset to receive at the destination.

Example:

"USDC"

developer_fee_bps

integer<int32>

Developer fee (client revenue share) in basis points. When set, updates the fee applied to FUTURE transactions on this account; existing transactions are unaffected. Routing fields remain immutable.

Required range: 0 <= x <= 10000

Example:

50

Response

Account updated successfully.

Unified account response for onramp/offramp/swap.

string

required

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.

Required string length: 27

Pattern: ^[0-9A-Za-z]{27}$

Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

account_type

enum<string>

required

Unified account family for account resources.

Available options:

onramp,

offramp,

swap

Example:

"onramp"

bank_account

Bank Account · object

Unified schema for bank accounts.

Show child attributes

destination

Crypto Destination Response · object

Response for a crypto destination.

Crypto Destination Response
Crypto Destination Response
Crypto Destination Response
US Fiat Destination Response
IBAN Fiat Destination Response

Show child attributes

source_crypto_address

string

Source crypto address for offramp/swap accounts.

Example:

"0x1234"

source_family

enum<string>

Blockchain family for the crypto account.

Available options:

evm,

solana

Example:

"evm"

source_network_id

enum<string>

Identifier for a blockchain network

Available options:

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

Required string length: 1 - 30

Example:

"ethereum-mainnet"

source_asset

string

Asset sent into the account.

Example:

"USDC"

destination_asset

string

Asset received at the destination.

Example:

"USDC"

rail

enum<string>

Type of payment rail capability supported. For onramp accounts, us_bank_account indicates the account accepts both ACH and Wire (Fedwire) deposits interchangeably.

Available options:

ach,

fedwire,

swift,

us_bank_account

Example:

"ach"

destination_rail

enum<string>

Type of payment rail capability supported. For onramp accounts, us_bank_account indicates the account accepts both ACH and Wire (Fedwire) deposits interchangeably.

Available options:

ach,

fedwire,

swift,

us_bank_account

Example:

"ach"

Delete an account Get details of a specific auto account transaction

⌘I

API documentation

Customers

Wallets

Transactions

Recipients

Accounts

Auto Transactions

Onboarding

Policies

Signer Groups

Authentication

Users

Webhooks

Events

Info

Sandbox

Self Serve

Agentic Payments

Mandates

Insights

Payouts

Update an account

Authorizations

Headers

Path Parameters

Body

Response