Skip to main content

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

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

Параметры пути

layoutId
integer
required
ID макета формы, который нужно обновить. Макет должен принадлежать текущей школе.

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

Все параметры тела запроса являются необязательными. Передайте только те поля, которые нужно обновить.
mode
enum
Режим макета формы. Возможные значения: Custom, Form, Signup, Welcome, Participant.
name
string
Название макета формы. Максимум 255 символов.
internalName
string
Внутреннее название макета. Максимум 255 символов.
status
enum
Статус макета. Возможные значения: Draft, Published.
slug
string
Символьный код макета. От 1 до 50 символов. Должен быть уникальным в рамках школы.
note
string
Заметка к макету. Максимум 255 символов.
productIds
integer[]
Массив ID продуктов, к которым привязан макет. При передаче — полностью заменяет текущий список привязанных продуктов.
config
object
Настройки макета.
curl --location --request PUT 'https://api.exode.biz/saas/v2/form/layout/5/update' \
  --header 'Seller-Id: {{ sellerId }}' \
  --header 'School-Id: {{ schoolId }}' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --data-raw '{
    "name": "Обновлённое название",
    "status": "Published",
    "config": {
      "resubmitMode": "NotAllowed"
    }
  }'
{
  "success": true,
  "code": 200,
  "payload": {
    "id": 5,
    "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "mode": "Custom",
    "status": "Published",
    "slug": "client-extra",
    "name": "Обновлённое название",
    "note": "Дополнительные поля для CRM",
    "config": {
      "resubmitMode": "NotAllowed"
    },
    "sellerId": 1,
    "createdAt": "2025-03-10T12:00:00.000Z",
    "updatedAt": "2025-03-12T09:15:00.000Z"
  }
}

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

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