Skip to main content
GET
List tasks
In the Heliyos MCP server: heliyos_tasks_list.

Authorizations

Authorization
string
header
required

A workspace API key, sent as Authorization: Bearer heliyos_.... Create one in Heliyos under Settings → API keys. A key acts as a workspace admin in the one workspace it was created in.

Query Parameters

limit
integer
default:20

Tasks per page, 1 to 100. Defaults to 20.

Required range: 1 <= x <= 100
cursor
string

The next_cursor from the previous page. Only valid with the default order (no sort, no groupBy); a 400 otherwise. When you send both cursor and page, cursor wins. next_cursor from the previous page; only valid with the default sort.

Maximum string length: 200
page
integer

A page number, starting at 1, for page-number paging. Pages are limit tasks long.

Required range: x >= 1
filters
string

A JSON object, URL-encoded. Keys:

  • search (string): matches text in the title or description, case-insensitive.
  • relatedObjectId (id): only tasks linked to this record.
  • filters (array): conditions { "field", "operator", "value", "conjunction" }. Conditions are combined with AND; a condition with "conjunction": "or" joins an OR group instead. Operators: equals, not_equals, contains, in (value is a list), gt or after, gte, lt or before, lte, empty, not_empty. Fields include status, priority, title, description, dueDate, isFinished (value "true" or "false" as a string), assignedUser (matches the assignee's name, case-insensitive), metadata.created.by (a user id), metadata.created.at and metadata.updated.at (equals matches the whole day, plus after, before).
  • sort (array): { "field", "direction" } with direction asc or desc, for example [{"field": "dueDate", "direction": "asc"}]. Text sorts ignore case.
  • groupBy (string): one of status, priority, assignedUser, dueDate, createdAt, isFinished, title. Each item in data is then a group { groupValue, count, tasks } instead of a task. Grouping by status or priority returns one group per value, each with its total count and its first pageSize tasks. Other groupings return at most 1000 tasks in all.
  • page and pageSize: page-number paging. pageSize is capped at 200. JSON-encoded filter object (search, filters, sort, page, pageSize). Optional. pageSize above 200 is clamped to 200.
Maximum string length: 20000

Response

A page of tasks.

meta
object
required
data
object[]
required