upservice_list_tasks
List and search tasks using filters for kind, project, author, responsible, date ranges, and tags.
Instructions
List/search tasks with optional filters for kind, project, author, responsible, date ranges, and tags.
CONFIRMED LIMITATION (verified against the live API, not just the OpenAPI spec): this
endpoint has no status/status_in/is_completed/completed/query filter. Passing any of
those as extra query params is silently ignored server-side (no error, no effect on
results) — status filtering must be done client-side on the returned status field.
There is no workaround on the Upservice API today; this has been reported to Upservice
as a feature request. Until it lands, narrow results with date_end_gte/date_end_lte
(due-date range) plus project/author/responsible BEFORE paginating and filtering
by status client-side — e.g. for "open overdue tasks", pass
date_end_lte=<now, ISO 8601> together with project/responsible to get a small candidate
set, then drop any whose status is completed/cancelled/rejected/deleted. Do not call
this with only author (or no filters) and try to page through everything — accounts
can have 100k+ tasks and completed_at/date filters are the only server-side way to keep
that bounded.
Args: params (ListTasksInput): limit, offset, kind, project, author, responsible, created_at_gte/lte, completed_at_gte/lte, date_start_gte/lte, date_end_gte/lte, tags_ids, tags_condition (all optional except pagination defaults)
Returns: str: JSON list of tasks matching the filters.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |