Endpoint: GET /tasks

Query parameters

• filters object (required)

  Supported operators: and, or, and not.

  Supported attributes:

  • id
  • index
  • listIds
  • assigneesIds
  • deleted (not supported with query)
  • deletedAt (not supported with query)
  • deletedByUserId (not supported with query)
  • completed
  • completedAt
  • createdAt
  • createdUserId
  • lastActivityAt
  • parentTaskId
  • status
  • trashedAt
  • trashed
  • trashedByUserId
  • or any field template id

  Filter format:

  • values array of string/UUID/boolean/NONE_VALUE_ID (required)

    You can use NONE_VALUE_ID to ask for task with an empty attribute.

  • gt

    Use to find tasks with a date greater than the date provided.

    • date Date (see Date formats)

  • lt

    Use to find tasks with a date less than the date provided.

    • date Date (see Date formats)

  Full syntax

  type Operator = 'and' | 'or' | 'not'
  type AttributeName = 'id' | 'index' | 'listIds' | […]
  type Filter = {
  	values?: Array<string | UUID | boolean | NONE_VALUE_ID>,
  	gt?: Date,
  	lt?: Date,
  }
  type Filters = {
  	Operator: Array<Filters>,
  } | {
  	AttributeName: Filter,
  };
  

  Example 1 (simple query)

  {
    "status": {
      "values": ["backLog", "inProgress"]
    },
    "assigneeId": {
      "values": ["123e4567-e89b-12d3-a456-426655440000"]
    },
  	"completed": {
  	  "values": [false]
    },
  	"lastActivityAt": {
  		"values": [],
  		"gt": {"date":"2019-11-07T17:00:00.000Z"},
    }
  }
  

Example 2 (with operators)

{
  "or": [{
		"status": {
	    "values": ["backLog", "inProgress"]
	  },
	}, {
		"not": [{
			"assigneeId": {
		    "values": ["123e4567-e89b-12d3-a456-426655440000"]
		  },
		}],
	}
}