CRM leads

Массово изменить лиды

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

post/api/v1/crm/leads/bulk

Request

  • Base URL: https://erp.akeda.ru
  • URL: https://erp.akeda.ru/api/v1/crm/leads/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)

Headers

X-Tenantstring required

Slug выбранного кабинета; кабинет не является юрлицом

Request body

idsUUID[] required

Выбранные лиды: от 1 до 200, повторы отбрасываются

action'assign' | 'move' | 'archive' | 'restore' required

Действие: assign — сменить ответственного, move — перенести на этап, archive — убрать в архив, restore — вернуть из архива

owner_idinteger

Новый ответственный; обязателен для assign

stage_idstring uuid

Response

Изменённые лиды и пропущенные с причиной

updatedUUID[] required

Изменённые записи

Changes

No recorded changes to this operation across all 1 revision of this API.