---
title: "Изменить представление списка CRM"
method: PATCH
path: "/api/v1/crm/views/{id}"
tags: ["CRM views"]
---

# Изменить представление списка CRM

`PATCH /api/v1/crm/views/{id}`

## Request

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

Переименовывает представление, пересохраняет его отбор и столбцы или делает общим. Поле, которого нет в запросе, не меняется; список представления не меняется. Своё личное представление правит автор, общее — администратор CRM; сделать представление общим или снова личным может тоже только он (иначе 403 crm.view_shared_forbidden). Чужое личное представление отвечает 404.

## Request body

- CRMSavedViewPatch: Поле, которого нет в запросе, не меняется
  - `name` string
  - `shared` boolean: Общее представление: сделать общим или личным может только администратор CRM
  - `filters` object: Новый отбор списка
  - `columns` object: Новая раскладка столбцов

## Response `200`

Изменённое представление

- 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`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю

---

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