---
title: "Сохранить представление списка CRM"
method: POST
path: "/api/v1/crm/views"
tags: ["CRM views"]
---

# Сохранить представление списка CRM

`POST /api/v1/crm/views`

## Request

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

Сохраняет отбор и раскладку столбцов списка лидов, сделок или клиентов под своим названием. Личное представление видит и правит только его автор. Общее (shared=true) видят все, кому открыт список, а заводит только администратор CRM — иначе 403 crm.view_shared_forbidden. Неверный список, название или не-объект в отборе и столбцах отклоняются 400: crm.view_list_invalid, crm.view_name_invalid, crm.view_json_invalid.

## Headers

- `X-Tenant` string, required

## Request body

- CRMSavedViewInput
  - `list` 'leads' | 'deals' | 'customers', required: Список CRM, у которого есть представления: лиды, сделки или клиенты
  - `name` string, required: Название в меню «Мои представления»; пробелы по краям обрезаются
  - `shared` boolean: Общее представление: заводит только администратор CRM
  - `filters` object: Отбор списка; без значения — пустой объект
  - `columns` object: Раскладка столбцов; без значения — пустой объект

## Response `201`

Сохранённое представление

- CRMSavedView: Сохранённое представление списка: отбор и раскладка столбцов под своим названием
  - `id` string, uuid, required
  - `owner_id` integer, required: Автор представления
  - `list` 'leads' | 'deals' | 'customers', required: Список CRM, у которого есть представления: лиды, сделки или клиенты
  - `name` string, required
  - `shared` boolean, required: Общее представление видят все, кому открыт список; личное — только автор
  - `filters` object, required: Отбор списка в форме экрана
  - `columns` object, required: Видимость, порядок и ширина столбцов в форме экрана
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, 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)