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

Поиск задач и проектов

GET /api/public/v1/tasks/search - find задачи по тексту + базовым фильтрам. Все фильтры опциональны, объединяются через AND. Требует scope tasks:read.

ПараметрТипОписание
qstring (max 200)Подстрока в title, case-insensitive
statusstring (repeatable)Принимает 3 формата (см. Status в payload): Semantic alias (lowercase): open (все !done), closed/done (все done), todo, in-progress, blocked. System key (case-insensitive): Todo, InProgress, Done, Blocked, Custom1..Custom12. Per-project label: точное название колонки в kanban проекта (например На ревью). Требует projectId для точного scope (иначе first-match по аккаунту). Multiple statuses: передайте несколько значений через запятую (?status=open,blocked) или повторите параметр (&status=open&status=blocked).
createdAfterISO-8601 datetimeЗадачи, созданные после указанного момента (включительно). Пример: 2026-01-01T00:00:00Z.
createdBeforeISO-8601 datetimeЗадачи, созданные до указанного момента (включительно).
dueAfterISO-8601 datetimeЗадачи, у которых dueDate >= значение.
dueBeforeISO-8601 datetimeЗадачи, у которых dueDate <= значение.
sortBystringПоле для сортировки: id (default), createdAt, updatedAt, dueDate, title.
sortDirstringНаправление сортировки: desc (default), asc.
assigneeint (repeatable)userId исполнителя. Multi-value: ?assignee=5,7 или &assignee=5&assignee=7 - OR.
projectIdint (repeatable)ID проекта. Multi-value: ?projectId=10,20 - OR.
tagstring (repeatable, max 50)Ключ тега. Multi-value: ?tag=urgent,critical - OR (matches если ЛЮБОЙ из tags present).
pageint (>=1)Default 1
pageSizeint (1..200)Default 50
GET /api/public/v1/tasks/search?q=отчёт&status=InProgress
GET /api/public/v1/tasks/search?assignee=12&projectId=5&page=2
GET /api/public/v1/tasks/search?q=API&pageSize=100
GET /api/public/v1/tasks/search?status=open - все незакрытые
GET /api/public/v1/tasks/search?status=closed - все закрытые (system Done + custom done)
GET /api/public/v1/tasks/search?status=На%20ревью&projectId=12 - все из колонки «На ревью» в проекте 12
GET /api/public/v1/tasks/search?status=Custom1 - задачи с конкретным слотом Custom1
# Multiple statuses
GET /api/public/v1/tasks/search?status=open,blocked
GET /api/public/v1/tasks/search?status=open&status=blocked
# Multi-value assignee (OR)
GET /api/public/v1/tasks/search?assignee=5,7
GET /api/public/v1/tasks/search?assignee=5&assignee=7
# Multi-value projectId (OR)
GET /api/public/v1/tasks/search?projectId=10,20
# Tag filter (OR within tag values)
GET /api/public/v1/tasks/search?tag=urgent
GET /api/public/v1/tasks/search?tag=urgent,critical
# Date ranges + status + sorting
GET /api/public/v1/tasks/search?createdAfter=2026-01-01T00:00:00Z&status=closed&sortBy=updatedAt&sortDir=desc
GET /api/public/v1/tasks/search?status=open,blocked&dueBefore=2026-06-01T00:00:00Z&sortBy=dueDate

Ответ - { items: PublicTaskDto[], page, pageSize, total }. Сортировка по умолчанию: id DESC (новые первыми); задаётся через sortBy/sortDir.

GET /api/public/v1/projects/search - Требует scope projects:read.

ПараметрТипОписание
qstring (max 200)Подстрока в name, case-insensitive
statusstringactive (default включает все non-deleted active) или archived
page/pageSizeintPagination как в tasks/search
GET /api/public/v1/projects/search?q=инфра
GET /api/public/v1/projects/search?status=archived

Все условия объединяются через AND; внутри каждого multi-value фильтра (status, assignee, projectId, tag) действует OR. Порядок результатов задаётся через sortBy/sortDir.

Если нужны дополнительные возможности - напишите в support.