Skip to main content

Заголовки запроса

string
required
API токен сервисного пользователя в формате Bearer. Получите токен в панели администратора школы. Формат: Bearer YOUR_TOKEN.
string
required
Уникальный идентификатор продавца в системе. Используется для разграничения доступа между разными продавцами.
string
required
Уникальный идентификатор школы в системе. Определяет контекст выполнения операции.
Требуется аутентификация и право FormManage.

Параметры запроса

Доступны два формата передачи значений: по slug (рекомендуемый) и по fieldId (расширенный).
integer
required
ID пользователя, для которого устанавливаются значения полей. Пользователь должен быть участником указанной школы.
integer
required
ID макета формы, к которому принадлежат поля. Макет должен принадлежать текущей школе.

Формат 1: По slug (рекомендуемый)

Эндпоинт: POST /saas/v2/form/custom-field/value/set-by-slug Упрощённый формат — тип значения определяется автоматически на основе типа поля в макете.
object[]
required
Массив значений полей. Минимум 1 элемент.

Формат 2: По fieldId (расширенный)

Эндпоинт: POST /saas/v2/form/custom-field/value/set Типизированный формат — вы сами указываете столбец для значения.
object[]
required
Массив значений полей. Минимум 1 элемент.
Оба метода работают в режиме upsert — если значение поля для данного пользователя уже существует, оно будет обновлено. Если не существует — будет создано.
Поля, у которых в настройках RBAC установлено api = false (доступ через API запрещён), не могут быть записаны через этот метод.

Требования к правам доступа

Для установки значений кастомных полей требуется право FormManage у сервисного пользователя.
Сервисный пользователь должен быть аутентифицирован по токену и иметь соответствующие права доступа к указанной школе.
Макет формы (layoutId) должен принадлежать текущей школе. Пользователь (userId) должен быть участником этой школы.

Обновлено: 2026-07-08 06:09 UTC