USusepylon
tasks

Search for tasks by a given filter

Changed on

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: 120 requests per minute

post/tasks/search

Request

  • Base URL
    https://api.usepylon.com
  • URL
    https://api.usepylon.com/tasks/search
  • Auth
    HTTP bearer

Request body

cursorstring

The cursor to use for pagination.

limitinteger

The number of tasks to fetch. Defaults to 100. Must be between 1 and 1000.

Example request

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

Response

request_idstring required

Example response

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

Changes

  • 8522e66913b4Revision changes
    • info

      added the new not enum value to the request property /

    • info

      added the new time_is_in_last enum value to the request property /

    • info

      added the new time_is_in_next enum value to the request property /

    • info

      added the new time_is_not_in_last enum value to the request property /

    • info

      added the new time_is_not_in_next enum value to the request property /

  • 05e40342a893Revision changes
    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status