---
title: "Массово изменить клиентов CRM"
method: POST
path: "/api/v1/crm/customers/bulk"
tags: ["CRM customers"]
---

# Массово изменить клиентов CRM

`POST /api/v1/crm/customers/bulk`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/crm/customers/bulk`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Одно действие над выбранными карточками клиентов: assign — сменить ответственного (owner_id), archive — убрать в архив, restore — вернуть из архива. Переноса на этап у клиентов нет. Каждая карточка меняется отдельно, с проверкой доступа, как при правке по одной; карточка, к которой действие не применилось, не мешает остальным и попадает в skipped с кодом и причиной. Весь запрос отклоняется 400 только при ошибке самого запроса: crm.bulk_invalid, crm.bulk_size, crm.bulk_action, crm.bulk_owner_required.

## Headers

- `X-Tenant` string, required

## Request body

- CRMBulkCustomersInput: Одно действие над выбранными карточками клиентов
  - `ids` UUID[], required: Выбранные клиенты: от 1 до 200, повторы отбрасываются
  - `action` 'assign' | 'archive' | 'restore', required: Действие: assign — сменить ответственного, archive — убрать в архив, restore — вернуть из архива
  - `owner_id` integer: Новый ответственный; обязателен для assign

## Response `200`

Изменённые карточки и пропущенные с причиной

- CRMBulkResult: Итог массового действия: подходящие записи изменены, неподходящие пропущены с причиной
  - `updated` UUID[], required: Изменённые записи
  - `skipped` CRMBulkSkip[], required: Пропущенные записи с причиной
    - `id` string, uuid, required
    - `code` string: Тот же код отказа, что вернула бы правка этой записи по одной, например crm.record_forbidden или crm.stage_fields_required
    - `detail` string, required: Причина на языке запроса

## Other responses

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

---

[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)