Update account

Updates account metadata. All accounts accept label; issued wallets also accept isDefault: true; issued bank accounts also accept settlement.accountId.

cURL

label

curl --request PATCH \
  --url https://platform.swipelux.com/v3/customers/{customerId}/accounts/{accountId} \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "label": "Operating wallet"
}
'

200

{
  "data": {
    "id": "acc_3eG7xN2pQ4rT8mA1sL6dVc",
    "type": "wallet",
    "network": "polygon",
    "origin": "issued",
    "status": "ready",
    "openTaskIds": [],
    "currency": "USDC",
    "label": "Operating wallet",
    "isDefault": true,
    "details": {
      "network": "polygon",
      "address": "0x1887b0a68bebc1b0d80a93567ba7002be92b8bd7"
    },
    "fees": {
      "breakdown": {
        "developer": null
      }
    },
    "createdAt": "2026-06-25T12:05:00.000Z",
    "updatedAt": "2026-06-26T12:04:00.000Z",
    "archivedAt": null
  }
}

Authorizations

X-API-Key · string · header · required

Headers

Idempotency-Key · string · required

Required for effectful v3 requests (POST, PATCH, PUT, DELETE). Reuse the same key with the same body to replay the cached response.

Required string length: 1 - 255

Path Parameters

customerId · string · required

accountId · string · required

Body

application/json

label · string | null

Account label. Send null to clear it.

settlement · object

Show child attributes

isDefault · enum<boolean>

Set this issued wallet as the default for its customer and currency.

Available options: true

Response

200

application/json

Account updated

data · object · required

Show child attributes