Fetch Tasks By IDs

POST 
/projects/tasks/batch

Fetches multiple tasks by id in one call. Results are RBAC-filtered — inaccessible ids are omitted rather than erroring. Does not return embedded subtasks.

Request

Version stringrequired

API Version

Available optionsv3

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

application/json

Body

Bodyrequired

idsstring[]required

Task IDs to fetch (1–100)

Possible values: >= 1, <= 100

Example (auto)

{
  "ids": [
    "7bl3Bl5tSiAAdzWfI2gc"
  ]
}

application/json

Successful response

application/json

Schema

Schema

tasksobject[]required

Tasks for the requested ids (RBAC-filtered)

Example (auto)

{
  "tasks": [
    {
      "id": "6a102435124ecfb348bd5509",
      "locationId": "ve9EPM428h8b87FE9C12Kg",
      "objectKey": "task",
      "assignees": [
        "user_1"
      ],
      "properties": {
        "title": "Follow up with client",
        "status": "to_do",
        "dueDate": "2026-09-20T17:00:00.000Z",
        "priority": 2,
        "primaryListId": "6a102435124ecfb348bd5507"
      }
    }
  ]
}