# update_account_metadata

`POST /api/v1/commands/update_account_metadata`

Base URL: `https://boringbooks.io`.



## Request body

| Field | Type | Required | Description |
|---|---|---|---|
| `id` | string (uuid) | yes |  |
| `dimension_rules` | object, nullable | no | Which dimensions a line on this account must or may carry, keyed by a dimension the ledger defines: `{"department": "required"}`. A dimension left out may not be used on the account. Send `{}` or `null` to lift every restriction. |
| `name` | string | no | Min length: `1`. Max length: `255`. |

Example:

```json
{
  "id": "22222222-2222-4222-8222-222222222222",
  "name": "Cash and cash equivalents"
}
```

## Response (200)

| Field | Type | Required | Description |
|---|---|---|---|
| `id` | string (uuid) | yes |  |
| `name` | string | yes |  |


## Errors

Every error response is a single `error` object with a closed `type` and a refining
`code`. The codes, and the conventions every operation shares, are in
[llms-full.txt](https://boringbooks.io/llms-full.txt).
