---
title: "Заменить бизнесы сотрудника"
method: PUT
path: "/api/v1/settings/members/{id}/access"
tags: ["Settings members"]
---

# Заменить бизнесы сотрудника

`PUT /api/v1/settings/members/{id}/access`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/settings/members/{id}/access`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Записывает область сотрудника целиком: все бизнесы кабинета, включая заведённые позже, или перечисленные бизнесы, внутри бизнеса — при желании только выбранные юрлица. Роль у сотрудника одна и меняется правкой участника; область сужает данные каждого права роли. Отказ с кодом settings.access.* — 400: нет бизнесов, бизнес не найден, юрлицо чужого бизнеса. Администратор кабинета работает во всех бизнесах, сузить его область нельзя — 409 settings.access.admin_all_businesses.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Tenant` string, required

## Request body

- SettingsMemberAccessInput
  - `all_businesses` boolean: Все бизнесы кабинета; тогда businesses не передаётся
  - `businesses` SettingsMemberBusinessScope[]: Бизнесы сотрудника целиком; повторы и юрлица бизнеса, выданного целиком, сворачиваются
    - `business` string, uuid, required
    - `company` string, uuid

## Response `200`

Участник с новой областью

- SettingsMember
  - `id` string, uuid, required
  - `user_id` integer, required: Идентификатор человека в общем реестре платформы
  - `username` string, required
  - `full_name` string, required
  - `birth_date` string, date, nullable, required
  - `avatar_url` string, required
  - `role` string, uuid, required
  - `role_name` string, nullable, required
  - `company_scope` 'all' | 'selected', required
  - `companies` UUID[], required: Заполнен при company_scope selected
  - `is_active` boolean, required
  - `all_businesses` boolean, required: Роль действует во всех бизнесах кабинета, включая заведённые позже. У администратора всегда true
  - `businesses` SettingsMemberBusinessScope[], required: Бизнесы сотрудника; пуст при all_businesses
    - `business` string, uuid, required
    - `company` string, uuid
  - `access_until` string, date, nullable, required: Последний день доступа в этом кабинете: после конца этого дня в поясе кабинета вход закрыт. null — доступ бессрочный
  - `access_closed` boolean, required: Последний день доступа уже прошёл: участник числится активным, но войти не может и места тарифа не занимает
  - `is_guest` boolean, required: Гость-подрядчик (карточка «Команды» с affiliation guest): права роли сужены до задач, чата и файлов «только где участник», места тарифа не занимает

## Other responses

- `400`: Некорректный запрос или нарушение бизнес-правила
- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю
- `409`: Конфликт версии, идемпотентности или бизнес-состояния
- `503`: Справочник бизнесов кабинета недоступен

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)