latestOpenAPI 3.0.32026-08-20147323331.7 KB

a7231589e927

tasks

Search for tasks by a given filter

Filterable fields and their allowed operators:

FieldAllowed operators
account_idequals, in, not_in, is_set
project_idequals, in, not_in, is_set, is_unset
statusequals, in, not_in
assignee_idequals, in, not_in, is_set
milestone_idequals, in, not_in, is_set
created_attime_is_after, time_is_before, time_range
due_datetime_is_after, time_is_before, time_range, is_set
updated_attime_is_after, time_is_before, time_range

Timestamp values use RFC3339 format. Valid status values are not_started, in_progress, and completed. For custom fields, pass the field slug as field.

Rate limit: 20 requests per minute

post/tasks/search

Request body

cursorstring

The cursor to use for pagination.

limitinteger

The number of tasks to fetch. Defaults to 100. Must be greater than 0 and less than 1000.

Example request

{
  "filter": {
    "subfilters": [
      {
        "field": "state",
        "operator": "equals",
        "value": "new"
      }
    ]
  }
}

Response

request_idstring

Example response

{
  "data": [
    {
      "custom_fields": {
        "priority": {
          "value": "high"
        }
      }
    }
  ]
}