Справка по API

{ "groups": Group[] }

{ "group": Group }

{ "group": Group }

{ "group": Group }

{
  "lists": [
    {
      "id":        "6f8a6f4e-9b0e-4a82-9f6b-2a3f1e4a5d1a",
      "parent_id": null,
      "name":      "Работа",
      "color":     "#0a84ff",
      "icon":      "briefcase",
      "archived":  false,
      "is_owner":  true,
      "is_shared": false
    }
  ]
}

Списками можно делиться (на сайте - кнопка «Поделиться»). В ответе одновременно приходят и собственные, и шаренные; различить помогают два булевых поля:

• is_owner - true: вы владелец списка; false: участник чужого. Только владелец может редактировать сам список (имя, цвет, иконка, архивация, удаление, привязка к группе) - попытка участника даст 403. Содержимое (задачи и заметки) могут править оба.
• is_shared - true: у списка есть участники (расшарен), независимо от вашей роли; false: сугубо личный.

В общих списках поля completed_user_id / deleted_user_id у задач показывают, кто реально закрыл/удалил заметку (а не её владельца).

{
  "list": {
    "id":        "6f8a6f4e-...",
    "parent_id": null,
    "name":      "Покупки",
    "color":     "#0a84ff",
    "icon":      null,
    "archived":  false
  }
}

{ "list": List }

{ "list": List }

{
  "parent_id": UUID | null   // null - вынести в корень
}

{ "list": List }

{
  "list":   { "id": "...", "name": "Работа" },
  "total":  42,
  "limit":  50,
  "offset": 0,
  "tasks":  [ Task, Task, ... ]
}

total - число задач, попавших под фильтр до применения limit/offset.

У каждой задачи (а также заметки и уведомления) есть массив files - вложения. Если ничего не прикреплено - массив пустой.

"files": [
  {
    "id":     "9f1c...",
    "name":   "contract.pdf",
    "size":   184320,                                 // байты
    "url":    "https://taskid.app/files/aa/bb/cc/9f1c....pdf",
    "source": "upload"                                // 'upload' | 'link'
  },
  {
    "id":     "1a2b...",
    "name":   "Status page",
    "size":   0,                                      // 0, если HEAD не вернул Content-Length
    "url":    "https://status.example.com/incidents/42",
    "source": "link"
  }
]

• source: "upload" - реально загруженный файл в нашем хранилище. url ведёт на taskid.app, скачивается прямым GET без заголовков (capability-токен зашит в путь). Учитывается в файловой квоте пользователя.
• source: "link" - внешний HTTPS-URL (наш сервер ничего не скачивает и не хранит). url ведёт на сторонний ресурс как есть. В квоте не учитывается; size может быть 0, если сервер ресурса не отдал Content-Length на HEAD-запросе при прикреплении.
• Удалённые/откреплённые файлы и ссылки в массиве не возвращаются.
• Прикрепить/открепить - см. «Прикрепить файлы и ссылки к задаче» и «Открепить файл/ссылку от задачи». Для заметок и уведомлений семантика идентичная.

{
  "task": {
    "id": "3c6b...-...-...",
    "list_id": "6f8a6f4e-...",
    "title": "Позвонить врачу",
    "note": null,
    "due_at": "2026-04-20T08:00:00Z",
    "due_has_time": true,
    "completed_at": null,
    "flagged": true,
    "priority": 2,
    "sort_order": 12000,
    "files": [],
    "version": "2026-04-18T12:34:56Z",
    "updated_at": "2026-04-18T12:34:56Z"
  }
}

{ "task": Task }

{ "task": Task }

Полная структура полей задачи - в разделе «Типы данных».

{ "task": Task }

{ "task": Task }

{
  "parent_id": UUID | null   // null - отвязать
}

• родитель должен быть в том же списке, что и задача;
• родитель сам не должен быть подзадачей (иерархия одноуровневая);
• задача :id не должна иметь собственных подзадач;
• нельзя сделать задачу подзадачей самой себя.

{ "task": Task }

Полную обновлённую задачу с уже прикреплёнными файлами и ссылками в поле files (см. «Типы данных» - формат единый, с маркером source):

{
  "task": {
    "id":     "TASK_ID",
    "title":  "Договор с подрядчиком",
    "note":   null,
    "files": [
      {
        "id":     "9f1c-...",
        "name":   "contract.pdf",
        "size":   184320,
        "url":    "https://taskid.app/files/aa/bb/cc/9f1c....pdf",
        "source": "upload"
      },
      {
        "id":     "1a2b-...",
        "name":   "Dashboard",
        "size":   0,
        "url":    "https://grafana.example.com/d/api",
        "source": "link"
      }
    ],
    ...                            // остальные поля задачи - см. «Типы данных»
  }
}

Полную обновлённую задачу - в массиве files этого файла больше нет:

{
  "task": {
    "id":    "TASK_ID",
    "title": "Договор с подрядчиком",
    "files": [],         // или массив с другими, оставшимися файлами
    ...
  }
}

Если такого файла к задаче не прикреплено (или его уже открепили раньше) - вернётся 404.

• limit - 1..500, по умолчанию 100
• offset - с какой заметки, по умолчанию 0

{
  "list":    { "id": UUID, "name": string },
  "total":   number,
  "limit":   number,
  "offset":  number,
  "records": InfoRecord[]
}

У заметки есть массив files с теми же полями, что у задачи: id, name, size, url (абсолютный, Authorization не нужен). Откреплённые/удалённые файлы не возвращаются. Прикрепить/открепить файл - см. «Прикрепить файлы к заметке» и «Открепить файл от заметки».

{
  "record": {
    "id":         "INFO_ID",
    "list_id":    "LIST_ID",
    "title":      "Wi-Fi пароль",
    "note":       "Secret1234",
    "sort_order": 12000,
    "files":      [],
    "version":    "2026-04-18T12:34:56Z",
    "updated_at": "2026-04-18T12:34:56Z"
  }
}

{ "record": InfoRecord }

{ "record": InfoRecord }   // полная заметка после изменений

Структура полей - в разделе «Типы данных».

{
  "file_ids": ["UUID", ...],            // опционально
  "links":    [{ "url": "...", "name": "..." }, ...]  // опционально
}

Полную обновлённую заметку - в массиве files уже видны прикреплённые файлы и ссылки:

{
  "record": {
    "id":    "INFO_ID",
    "title": "Wi-Fi пароль",
    "note":  "Secret1234",
    "files": [
      {
        "id":     "9f1c-...",
        "name":   "router-photo.jpg",
        "size":   92210,
        "url":    "https://taskid.app/files/aa/bb/cc/9f1c....jpg",
        "source": "upload"
      },
      {
        "id":     "1a2b-...",
        "name":   "Wiki",
        "size":   0,
        "url":    "https://wiki.example.com/wifi",
        "source": "link"
      }
    ],
    ...
  }
}

Полную обновлённую заметку - этого файла в массиве files уже нет:

{
  "record": {
    "id":    "INFO_ID",
    "title": "Wi-Fi пароль",
    "files": [],         // или другие, оставшиеся файлы
    ...
  }
}

Если такого файла к заметке не прикреплено - вернётся 404.

{
  "notification": {
    "id":           "NOTIF_ID",
    "list_id":      null,
    "title":        "Прод упал",
    "note":         "503 на api.example.com",
    "priority":     3,
    "completed_at": null,
    "sort_order":   12000,
    "files": [
      {
        "id":     "1a2b-...",
        "name":   "Dashboard",
        "size":   0,
        "url":    "https://grafana.example.com/d/api",
        "source": "link"
      }
    ],
    "version":      "2026-04-18T12:34:56Z",
    "updated_at":   "2026-04-18T12:34:56Z",
    "date_create":  "2026-04-18T12:34:56Z"
  }
}

HTTP 201 при создании. Если запрос повторно пришёл с тем же Idempotency-Key - HTTP 200 с тем же телом (новая запись не создаётся).

Не путать с write_notifications - тот разрешает только создавать уведомления (POST /notifications). Для прикрепления файлов нужен полноценный write.

{
  "file_ids": ["UUID", ...],            // опционально
  "links":    [{ "url": "...", "name": "..." }, ...]  // опционально
}

multipart/form-data. Поле формы - files (можно несколько) или file (одиночный). Принимаются оба варианта.

{
  "files": [
    { "id": "9f1c-...", "name": "contract.pdf", "size": 184320 },
    { "id": "5b2e-...", "name": "photo.jpg",    "size":  92210 }
  ]
}

URL для скачивания на этом шаге не отдаётся - он понадобится только когда файл будет прикреплён к задаче или заметке; там он уже придёт абсолютным в массиве files.

• 400 - тело не multipart или нет файлов / пустой файл.
• 413 - превышен максимальный размер запроса или одного файла.
• 507 - превышена квота хранилища пользователя.

{
  "id":        UUID,
  "parent_id": UUID | null,   // UUID группы, в которой лежит список
  "name":      string,
  "color":     string | null, // HEX или имя токена темы
  "icon":      string | null, // SF Symbol
  "archived":  boolean,
  "is_owner":  boolean,       // вы владелец списка
  "is_shared": boolean        // у списка есть участники
}

{
  "id":       UUID,
  "name":     string,
  "color":    string | null,
  "icon":     string | null,
  "archived": boolean
}

{
  "id":            UUID,
  "list_id":       UUID | null,
  "parent_id":     UUID | null,   // для подзадач
  "title":         string,
  "note":          string | null,
  "due_at":        string | null, // ISO-8601 UTC
  "due_has_time":  boolean,
  "completed_at":  string | null, // ISO-8601 UTC
  "flagged":       boolean,
  "priority":      0 | 1 | 2 | 3,
  "rrule_freq":     0 | 1 | 2 | 3 | 4 | 5, // 0=нет, HOURLY/DAILY/WEEKLY/MONTHLY/YEARLY
  "rrule_interval": number,  // >=1
  "rrule_byday":    number,  // битмаска Пн=1..Вс=64
  "rrule_bymonth":  number,  // битмаска янв=1..дек=2048
  "rrule_bysetpos": number,  // 1..4 или -1, 0=не задан
  "rrule_end_kind": 0 | 1 | 2, // 0=никогда, 1=до даты, 2=после N
  "rrule_until":    string | null, // ISO-8601 UTC
  "rrule_count":    number,
  "rrule_done":     number,
  "rrule_anchor":   0 | 1, // 0=schedule, 1=completion
  "in_my_day":     boolean,
  "in_my_day_date": string | null, // YYYY-MM-DD
  "sort_order":    number,
  "collapsed":     0 | 1,          // 1 = подзадачи свёрнуты
  "files":         FileRef[],      // см. «Прикреплённые файлы»
  "version":       string,    // ISO-8601 UTC, обновляется на сервере
  "updated_at":    string,    // ISO-8601 UTC
  "date_create":   string,    // ISO-8601 UTC
  "completed_user_id": UUID | null, // кто закрыл (важно в общих списках)
  "deleted_user_id":   UUID | null  // кто удалил
}

{
  "id":         UUID,
  "list_id":    UUID,        // всегда привязан к конкретному списку
  "title":      string,
  "note":       string | null,
  "sort_order": number,
  "files":      FileRef[],   // см. «Прикреплённые файлы»
  "version":    string,      // ISO-8601 UTC
  "updated_at": string       // ISO-8601 UTC
}

{
  "id":   UUID,
  "name": string,    // оригинальное имя файла
  "size": number,    // размер в байтах
  "url":  string     // абсолютный URL (https://taskid.app/files/...)
}