---
title: "Update staff role, company access and family access"
method: PATCH
path: "/firm-staff/{staffId}"
tags: ["Firm Staff"]
---

# Update staff role, company access and family access

`PATCH /firm-staff/{staffId}`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/firm-staff/{staffId}`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

Replaces the complete company assignment set. Staff Member requires at least one active managed company. Staff Admin ignores assignments and receives every company without firm books. Firm Admin receives firm books plus all companies. Optional familyIds replaces a Staff Member's active family assignments (archived families keep theirs); it requires an accepted invitation. Changing a role away from Staff Member clears family assignments, since other roles see every family.

## Path parameters

- `staffId` string, uuid, required

## Response `200`

Updated staff access policy

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)