PRproductive
Task Lists

Get task lists

Changed on

Returns a paginated list of task lists — the task groupings inside a project's folders. By default, task lists that belong to project templates are excluded; filtering by a specific project returns its task lists even when that project is a template. Supports filtering by project, folder, status, and free-text query, and sorting by board, folder, project, or company name.

get/api/v2/task_lists

Request

  • Base URL
    https://developer.productive.io (the document declares no server; this is the origin it was published from)
  • URL
    https://developer.productive.io/api/v2/task_lists
  • Auth
    none declared

Query parameters

OR

Filters

{
  "0": {
    "id": {
      "eq": "123"
    }
  },
  "$op": "and"
}
sortstring[]

Sort task list

Response

Collection task list

Example response

{
  "data": [
    {
      "id": "14308",
      "type": "task_lists",
      "attributes": {
        "name": "Sprint 42",
        "position": 1,
        "placement": 1000000,
        "archived_at": null,
        "email_key": "a1b2c3d4e5f6789012345678901234ab"
      },
      "relationships": {
        "project": {
          "data": {
            "type": "projects",
            "id": "6899"
          }
        },
        "folder": {
          "data": {
            "type": "folders",
            "id": "5522"
          }
        }
      }
    }
  ],
  "included": [],
  "meta": {
    "current_page": 1,
    "total_pages": 5,
    "total_count": 42,
    "page_size": 30,
    "max_page_size": 200
  }
}

Changes

  • fa3060fd0144Revision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • f11a8740641aRevision changes
    • breaking

      the /// response's property type changed from string to no type, and format from date-time to no format for status

    • breaking

      the /// response's property type changed from integer to no type for status

    • breaking

      the /// response's property type changed from integer to no type for status

    • warning

      deleted the header request parameter X-Organization-Id

    • warning

      removed the optional property /// from the response with the status

    This list may be incomplete.