API v1

Записи: запись

Создание, изменение и удаление записей. Требуется право records:write. Изменения пишутся в историю записи и вызывают вебхуки.

Создание, изменение и удаление записей. Требуется право records:write. Изменения пишутся в историю записи и вызывают вебхуки.

#Создание

bash

curl -X POST https://ВАШ_ДОМЕН/api/v1/collections/{collection}/records \
  -H "Authorization: Bearer ВАШ_ТОКЕН" \
  -H "Content-Type: application/json" \
  --data '{
    "title": "Поставка на 250 000 ₽",
    "stageId": "9e…stage-uuid",
    "values": { "9e…field-uuid": "Ромашка" }
  }'

Ответ — созданная запись (формат из статьи «Записи: чтение») со статусом 201.

#Изменение

bash

curl -X PATCH https://ВАШ_ДОМЕН/api/v1/records/{record} \
  -H "Authorization: Bearer ВАШ_ТОКЕН" \
  -H "Content-Type: application/json" \
  --data '{ "title": "Поставка на 300 000 ₽" }'

PATCH принимает только перечисленные поля (title, stageId, values) — остальные остаются без изменений.

#Удаление

http

DELETE /api/v1/records/{record}
Authorization: Bearer ВАШ_ТОКЕН

Ответ — {"ok": true}. Удаление мягкое: запись уходит из списков, но история и связи сохраняются.

Вебхуки record.created / record.updated / record.deleted срабатывают и на изменения через API.