Skip to main content
PUT
/
v1
/
ledger
/
{ledger_key}
/
account
/
{account_key}
Update Account
curl --request PUT \
  --url https://api.sandbox.nxos.io/v1/ledger/{ledger_key}/account/{account_key} \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "default_asset_code": "<string>",
  "status": "ACTIVE",
  "metadata": {}
}
'
{
  "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "account_ref": "<string>",
  "default_asset_code": "<string>",
  "enabled_assets": [
    {
      "asset_code": "<string>",
      "max_balance": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "min_balance": "<string>"
    }
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "status": "ACTIVE",
  "metadata": {}
}
This endpoint updates an account and associated asset rules

Headers

​
Authorization
string
required

The Basic Authentication header. Format: "Basic {base64(orgID:apiKey)}"

Path Parameters

​
ledger_key
string
required

The key of the ledger. Examples:

  • "123e4567-e89b-12d3-a456-426614174000"
  • "id:123e4567-e89b-12d3-a456-426614174000"
  • "ref:ledger:customer_a"
​
account_key
string
required

The key of the account. Examples:

  • "123e4567-e89b-12d3-a456-426614174000"
  • "id:123e4567-e89b-12d3-a456-426614174000"
  • "ref:internal:revenue:fx"

Body

application/json
​
default_asset_code
string

the new default asset code for the account

Minimum string length: 1
​
status
enum<string>

the new status for the account

Available options:
ACTIVE,
INACTIVE,
INACTIVE
​
metadata
object

the new metadata for the account, will overwrite existing metadata

Response

200 - application/json

The request has succeeded.

​
account_id
string<uuid>
required

The unique identifier of the account

​
account_ref
string
required

The externally defined reference of the account

Minimum string length: 1
​
default_asset_code
string
required

The default asset for the account

Minimum string length: 1
​
enabled_assets
object[]
required

The enabled assets for the account with asset rules such as min/max balances

​
created_at
string<date-time>
required
​
updated_at
string<date-time>
required
​
status
enum<string>

The status of the account, defaults to ACTIVE

Available options:
ACTIVE,
INACTIVE,
INACTIVE
​
metadata
object

Additional, optional, metadata for the account