Заголовки запроса
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 — если значение поля для данного пользователя уже существует, оно будет обновлено. Если не существует — будет создано.
Требования к правам доступа
Для установки значений кастомных полей требуется право FormManage у сервисного пользователя.
Макет формы (
layoutId) должен принадлежать текущей школе. Пользователь (userId) должен быть участником этой школы.Обновлено: 2026-07-08 06:09 UTC