Концепции
Account (аккаунт / команда)
Заголовок раздела «Account (аккаунт / команда)»Корневая сущность изоляции. Каждый ключ привязан к одному Account, и все endpoint’ы автоматически фильтруются по нему - кросс-аккаунтный доступ невозможен.
Project (проект)
Заголовок раздела «Project (проект)»Внутри аккаунта. Проекты могут вкладываться (parentProjectId) до 10 уровней. У задачи всегда есть projectId.
Task (задача)
Заголовок раздела «Task (задача)»Основная рабочая сущность: title, description, status, priority, dueDate, assigneeId. Имеет Version (int) - используется в ETag/If-Match для оптимистической конкурентности на PATCH.
Event (событие календаря)
Заголовок раздела «Event (событие календаря)»Account-level записи в календаре: startsAt, endsAt, allDay, location. В публичном API сейчас поддерживаются только одиночные события - серии и повторения пока недоступны.
Attachment (вложение)
Заголовок раздела «Attachment (вложение)»Файл, привязанный к задаче. Загружается через multipart/form-data; max 100 MB; учитывается в storage-квоте аккаунта.
Строка вида tasks:read, tasks:write, projects:read, projects:write, events:read, events:write, attachments:read, attachments:write, account:read. Привязывается к ключу при создании и проверяется middleware’ом на каждый запрос.
Webhook
Заголовок раздела «Webhook»Подписка (URL, секрет, eventTypes[]) на уровне аккаунта. Когда событие наступает, FlowWorker делает HTTP POST на ваш URL с HMAC-SHA256 подписью в заголовке X-FlowWorker-Signature.