/v1/accounting/access/{accountId}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.
Send request
Use the documented inputs to call this endpoint directly.
Parameters
Values are applied to the request and the example on the right.
Request body
application/jsonrequiredResponses
the action's answer
{
"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"
}
}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.
{
"error": "string"
}