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

Частично обновить событие.

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

Все поля в FlowWorker.Backend.PublicApi.Dto.PublicEventPatchDto опциональны - применяются только не-null значения. Если в результате и StartsAt, и EndsAt ненулевые, проверяется ограничение EndsAt >= StartsAt.

Поддерживает оптимистическую конкурентность: передавайте If-Match: "<version>" (из ETag предыдущего GET) - запрос отклоняется с 412, если событие было изменено после этого.

id
required
integer format: int32

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

Параметры заголовков

Заголовок раздела «Header Parameters »
If-Match
string

Опциональный заголовок If-Match с ожидаемым текущим токеном версии.

Patch-payload - применяются только не-null поля.

Тело запроса для PATCH /api/public/v1/events/{id}. Все поля опциональны; применяются только не-null значения.

object
title

Новое название (1..200 символов).

string
nullable
description

Новое описание (пустая строка/пробелы очищают поле).

string
nullable
startsAt

Новое время начала (нормализуется в UTC).

string format: date-time
nullable
endsAt

Новое время окончания (нормализуется в UTC); должно быть >= итогового StartsAt.

string format: date-time
nullable
allDay

Новый флаг «весь день».

boolean
nullable
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"
}

Обновлённое событие. Заголовок 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).

Событие не найдено.

Устаревшая версия в If-Match. Текущий ETag возвращается в ответе.