Перейти к содержимому

Создать событие календаря в текущем аккаунте.

POST
/api/public/v1/events
curl -X POST \
-H "Authorization: Bearer $FW_KEY" \
-H "Content-Type: application/json" \
-d '{ /* fields per request body schema */ }' \
"https://api.flowworker.ru/api/public/v1/events"

Проверяет, что при заданных обоих EndsAt >= StartsAt. Подчиняется лимитам тарифа аккаунта. Обе временные метки нормализуются в UTC и обрезаются до микросекундной точности, чтобы возвращаемый ETag совпадал с последующими чтениями.

Payload создания события.

Тело запроса для POST /api/public/v1/events.

object
title

Название (1..200 символов, обязательно).

string
nullable
description

Описание (опционально).

string
nullable
startsAt

Время начала (обязательно; нормализуется в UTC).

string format: date-time
endsAt

Время окончания (опционально; должно быть >= FlowWorker.Backend.PublicApi.Dto.PublicEventCreateDto.StartsAt, если задано).

string format: date-time
nullable
allDay

Флаг «весь день».

boolean
location

Текстовое поле «место» (опционально).

string
nullable
Example generated
{
"title": "example",
"description": "example",
"startsAt": "2026-04-15T12:00:00Z",
"endsAt": "2026-04-15T12:00:00Z",
"allDay": true,
"location": "example"
}

Созданная FlowWorker.Backend.PublicApi.Dto.PublicEventDto. Заголовок ETag содержит токен версии.

Одиночное событие календаря в аккаунте. Серии/повторы, участники, напоминания и привязки к задачам вне объёма M2 (TODO: M3).

object
id

Идентификатор события.

integer format: int32
title

Название.

string
nullable
description

Описание (свободный текст).

string
nullable
startsAt

Время начала (UTC).

string format: date-time
endsAt

Время окончания (UTC); null для открытых по времени событий.

string format: date-time
nullable
allDay

Флаг «весь день».

boolean
location

Текстовое поле «место».

string
nullable
createdAt

Время создания (UTC).

string format: date-time
updatedAt

Время последнего обновления (UTC; обрезано до микросекундной точности для round-trip через Postgres).

string format: date-time
version

Токен конкурентности для If-Match. Вычисляется из UpdatedAt.Ticks, поскольку у WorkEvent ещё нет отдельной колонки Version.

integer format: int64
Example
{
"id": 501,
"title": "Sprint planning",
"description": "Q3 priorities review.",
"startsAt": "2026-05-20T09:00:00Z",
"endsAt": "2026-05-20T10:00:00Z",
"allDay": false,
"location": "Zoom",
"createdAt": "2026-05-16T10:42:18Z",
"updatedAt": "2026-05-16T11:00:00Z",
"version": 638816520000000000
}

Ошибка валидации (отсутствует title, EndsAt раньше StartsAt).

Отсутствует scope events:write или аккаунт в limited-mode.