GET /v1/tasks — от/до и точный день; примеры и ошибки.

Фильтры по датам

Применяется только к GET /v1/tasks (скоуп tasks:read). Всегда вместе с обязательным boardId. Границы включительные, календарный день — UTC.

Полные сценарии со списками задач: Задачи.

Параметры

Параметры	Поле	Логика
`createdFrom` / `createdTo` / `createdOn`	`createdAt`	момент в диапазоне
`updatedFrom` / `updatedTo` / `updatedOn`	`updatedAt`	момент в диапазоне
`deadlineFrom` / `deadlineTo` / `deadlineOn`	`deadlineStart`…`deadlineEnd`	пересечение интервалов
`updatedSince`	`updatedAt`	устаревший синоним `updatedFrom`

*From / *To — ISO-8601 или YYYY-MM-DD (день → начало/конец UTC-дня).
*On=YYYY-MM-DD — весь UTC-день. Нельзя смешивать с *From/*To той же группы.
Задачи без дедлайна отсекаются при любом deadline*.

Пример: `createdOn`

Запрос

GET /v1/tasks?boardId=33333333-3333-4333-8333-333333333333&createdOn=2026-10-18&limit=50 HTTP/1.1
Host: api.aladdinhub.io
Authorization: Bearer ald_demoPrefix_mockSecretExampleOnly
Accept: application/json

Ответ `200`

{
  "data": [
    {
      "id": "22222222-2222-4222-8222-222222222222",
      "title": "Example task title",
      "createdAt": "2026-10-18T10:00:00.000Z",
      "updatedAt": "2026-10-18T11:00:00.000Z"
    }
  ],
  "nextCursor": null,
  "limit": 50
}

(поля сокращены для наглядности; полный объект — на странице задач.)

Ошибка `400` — конфликт с диапазоном

GET /v1/tasks?boardId=33333333-3333-4333-8333-333333333333&createdOn=2026-10-18&createdFrom=2026-10-01 HTTP/1.1

{
  "statusCode": 400,
  "message": "Do not combine createdOn with createdFrom/createdTo",
  "error": "Bad Request"
}

Пример: `updatedFrom` / `updatedTo`

Запрос

GET /v1/tasks?boardId=33333333-3333-4333-8333-333333333333&updatedFrom=2026-10-20&updatedTo=2026-10-24 HTTP/1.1
Host: api.aladdinhub.io
Authorization: Bearer ald_demoPrefix_mockSecretExampleOnly

Ответ `200`

{
  "data": [],
  "nextCursor": null,
  "limit": 50
}

Ошибка `400` — инвертированный диапазон

{
  "statusCode": 400,
  "message": "updatedFrom must be ≤ updatedTo",
  "error": "Bad Request"
}

Пример: `deadlineFrom` / `deadlineTo`

Запрос

GET /v1/tasks?boardId=33333333-3333-4333-8333-333333333333&deadlineFrom=2026-10-20&deadlineTo=2026-10-26 HTTP/1.1
Host: api.aladdinhub.io
Authorization: Bearer ald_demoPrefix_mockSecretExampleOnly

Ответ `200`

Оболочка { "data": [ … ], "nextCursor": null, "limit": 50 } — только задачи с пересекающимся дедлайном.

Ошибки

401 / 403 / 429 — как у любого GET /tasks (Ошибки).

Фильтры по датам

On this page