---
title: "Update subaccount preferences"
method: PUT
path: "/v4/account/subaccounts/{subAccountId}/preferences"
tags: ["Subaccounts"]
---

# Update subaccount preferences

`PUT /v4/account/subaccounts/{subAccountId}/preferences`

Update subaccount preferences such as label or is_hidden. Permission: `subaccount:write`.

## Path parameters

- `subAccountId` string, uuid, required

## Request body

- object
  - `label` string — Alphanumeric characters, underscores, dashes, spaces, and parentheses only.
  - `is_hidden` boolean

## Response `200`

Preferences updated

- object
  - `success` boolean
  - `message` string
  - `data` object
    - `AccountID` string, uuid
    - `label` string
    - `is_hidden` boolean

## Other responses

- `400` — Validation error — label fails length or character constraints
- `401` — Unauthorized
- `404` — Subaccount not found
- `500` — Internal server error — database write failed

---

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