Get Lists For A Task

GET 
/projects/tasks/:taskId/lists

Returns every list the task belongs to. The home list is the one with isHome: true (same id as properties.primaryListId). Other rows are additional lists. Move Task (PUT .../home-list) changes the home list.

Request

Version stringrequired

API Version

Available optionsv3

taskId stringrequired

Task id

locationId string

Location id. Required for channel: APP. Ignored for OAuth/PIT — those use the location on the auth token. Do not send in path, body, or headers.

application/json

Successful response

application/json

Schema

Schema

listsobject[]required

Accessible lists for the task (isHome marks the home list)

Example (auto)

{
  "lists": [
    {
      "id": "6a102435124ecfb348bd5507",
      "type": "list",
      "name": "Inbox",
      "isHome": true
    }
  ]
}