---
title: "Update CLOB account"
method: PATCH
path: "/clob/accounts"
tags: ["CLOB"]
---

# Update CLOB account

`PATCH /clob/accounts`

Updates `prefunded` and/or `account_tier` attributes of an account on the CLOB.

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Request body

- union
  - object — Request body for updating an account on the zerohash CLOB to a new commission tier. This request body format is used when the account to update can be identified by the participant code alone, without the need for a custom account label.
    - `account_label` string, required — The `account_label` associated with the account to update. If no `account_label` was provided at account creation, the default `account_label` is `general`.
    - `prefunded` boolean, required — Indicates whether the participant has prefunded their account or not.
    - `account_tier` 'bronze' | 'silver' | 'gold' — The commission tier associated with the participant's account, each commission tier is defined by the platform and can be configured upon request to the zerohash team.
    - `participant_code` string — The code of the participant that owns the account. Used when custom account_label has not been provided on account creation.
  - object — Request body for updating an account on the zerohash CLOB to a new commission tier. This request body format is used when the account to update can be identified by a custom account label.
    - `account_label` string, required — The `account_label` associated with the account to update. This is required when updating an account with a custom label.
    - `prefunded` boolean, required — Indicates whether the participant has prefunded their account or not.
    - `account_tier` 'bronze' | 'silver' | 'gold' — The commission tier associated with the participant's account, each commission tier is defined by the platform and can be configured upon request to the zerohash team.
    - `participant_code` string — The code of the participant that owns the account.

## Response `202`

CLOB account update accepted. Returns the updated attributes of the account.

- PatchPrefundedAccountResponse
  - `account_label` string — The platform-dictated account label for the account.
  - `prefunded` boolean — Indicates whether the participant has prefunded their account or not.
  - `account_tier` 'lite' | 'pro' | 'bronze' | 'silver' | 'gold' — The commission tier associated with the account, defined by the platform.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/zerohash/apis/zerohash-api.md) · [All operations](https://skmtc.net/zerohash/apis/zerohash-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zerohash/zerohash-api/revisions/8b647d934363/schema)