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

# Update subaccount preferences

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

## Request

- Base URL: `https://api.proxyscrape.com`
- URL: `https://api.proxyscrape.com/v4/account/subaccounts/{subAccountId}/preferences`
- Auth: API key in header `api-token`
- TypeScript: <https://skmtc.dev/proxyscrape/apis/proxyscrape-account-api/docs/v4/account/subaccounts/:subAccountId/preferences/put.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/proxyscrape/apis/proxyscrape-account-api.md) - [All operations](https://skmtc.dev/proxyscrape/apis/proxyscrape-account-api/llms.txt) - [OpenAPI document](https://skmtc.dev/proxyscrape/apis/proxyscrape-account-api/revisions/4e10267785e1?raw)