# Grant a seat the books

Hands one member the brokerage's books, or changes what they hold. Body: `level` (`read` opens the books; `manage` also books deals, lays stakes, reconciles bank lines and records costs), `allAccounts` (true reaches every linked company bank account and hand-imported lines), and `bankAccounts` — when `allAccounts` is false, the linked accounts the grant reaches, by the `id` each account carries in `get_accounting_plaid-connections`. The whole grant is replaced by the body. A grant never decides a payout or links a bank; those stay the admin seat's. The admin seat.

Access class: `workspace:admin`.

## Endpoint

`PUT /v1/accounting/access/{accountId}`

## Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| accountId | path | string | Yes |

## Request body

Content type: `application/json`.

```json
{
  "allAccounts": true,
  "bankAccounts": [
    "string"
  ],
  "level": "string"
}
```

## Responses

### 200

the action's answer

Content type: `application/json`.

```json
{
  "data": {
    "accountId": "",
    "allAccounts": true,
    "bankAccounts": [
      "string"
    ],
    "createdAt": "2026-01-01T00:00:00Z",
    "displayName": "string",
    "email": "string",
    "grantedBy": "string",
    "level": "string",
    "role": "string",
    "updatedAt": "2026-01-01T00:00:00Z"
  }
}
```

### default

a refusal: `{"error": "<what a person needs to read>"}`. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.

Content type: `application/json`.

```json
{
  "error": "string"
}
```
