Task Items — List & View

Retrieve task items from boards. Supports pagination, group filtering, text search, and status filtering. Item fields are subject to field masking based on the token's visibleTaskFields setting.

GET/api/access/tasks/boards/{boardId}/itemsBearer Token

List Items

List items/tasks within a board. Supports pagination, group filtering, text search, and status filtering.

Required permission: ViewItems

Path Parameters

Parameter	Type	Description
boardId	string	Board ID

Query Parameters

Parameter	Type	Default	Description
provider	string	auto	Provider code
limit	int	50	Max results (1–200)
cursor	string?	—	Cursor for pagination (Monday, Notion, Linear)
page	int?	—	Page number for pagination (Asana, Jira)
groupId	string?	—	Filter to items in a specific group/section
query	string?	—	Text search in item names (case-insensitive)
status	string?	—	Filter by status value

Response 200 OK

{ 
  "provider": "MONDAY", 
  "items": [ 
    { 
      "id": "987654321", 
      "name": "Fix login bug", 
      "status": "Working on it", 
      "assignees": ["John Doe"], 
      "dueDate": "2026-03-15T00:00:00Z", 
      "priority": "High", 
      "labels": ["Bug", "Frontend"], 
      "description": "Users can't log in on mobile", 
      "groupId": "new_group", 
      "groupName": "To Do", 
      "comments": [ 
        { 
          "id": "c123", 
          "body": "Reproduced on iOS 18", 
          "authorName": "Jane Smith", 
          "createdAt": "2026-03-30T14:22:00Z" 
        } 
      ], 
      "subItems": [], 
      "columnValues": [ 
        { 
          "columnId": "numbers0", 
          "columnTitle": "Story Points", 
          "type": "numbers", 
          "text": "5", 
          "value": "{\"value\":5}" 
        } 
      ] 
    } 
  ], 
  "nextCursor": "MSw5ODc2NTQzMjE=", 
  "nextPage": null, 
  "totalCount": 42, 
  "accessInfo": null 
}

Response Fields

Field	Type	Description
provider	string?	Provider code
items	Item[]	List of items (see Item object)
nextCursor	string?	Cursor for next page
nextPage	int?	Page number for next page
totalCount	int?	Total item count (when available from the provider)
accessInfo	string?	Restriction info

Error Responses

Status	Description
403	Board not in token scope
502	Provider error

GET/api/access/tasks/items/{itemId}Bearer Token

Get Item

Get a single item with all fields (subject to field masking).

Required permission: ViewItems

Path Parameters

Parameter	Type	Description
itemId	string	Item ID from the provider

Query Parameters

Parameter	Type	Default	Description
provider	string	auto	Provider code

Response 200 OK

{ 
  "provider": "MONDAY", 
  "item": { 
    "id": "987654321", 
    "name": "Fix login bug", 
    "status": "Working on it", 
    "assignees": ["John Doe"], 
    "dueDate": "2026-03-15T00:00:00Z", 
    "priority": "High", 
    "labels": ["Bug"], 
    "description": "Full description...", 
    "groupId": "new_group", 
    "groupName": "To Do", 
    "comments": [ 
      { 
        "id": "c123", 
        "body": "Reproduced on iOS 18", 
        "authorName": "Jane Smith", 
        "createdAt": "2026-03-30T14:22:00Z" 
      } 
    ], 
    "subItems": [], 
    "columnValues": [ 
      { 
        "columnId": "numbers0", 
        "columnTitle": "Story Points", 
        "type": "numbers", 
        "text": "5", 
        "value": "{\"value\":5}" 
      } 
    ] 
  }, 
  "accessInfo": null 
}

Response Fields

Field	Type	Description
provider	string?	Provider code
item	Item?	Item object (see Item object)
accessInfo	string?	Restriction info

Error Responses

Status	Description
403	Access denied — board not in scope or assignee restricted by access rules
404	Item doesn’t exist
502	Provider error

Data Types

Item Object

All fields except id, groupId, and groupName are subject to field masking based on the token's visibleTaskFields setting. Masked fields are returned as null.

Field	Type	Masked By	Description
id	string	never	Item ID from the provider
name	string?	Name	Item title
status	string?	Status	Status label text
assignees	string[]?	Assignee	Display names of assigned people
dueDate	datetime?	DueDate	Due date in UTC
priority	string?	Priority	Priority label text
labels	string[]?	Labels	Tags/labels on the item
description	string?	Description	Item description/notes
groupId	string?	never	Group this item belongs to
groupName	string?	never	Group display name
comments	Comment[]?	Comments	Item comments (see Comment object)
subItems	Item[]?	SubItems	Nested sub-items (same schema, recursive)
columnValues	ColumnValue[]?	ColumnValues	Provider-specific column data (see ColumnValue object)

Comment Object

Field	Type	Description
id	string	Comment ID
body	string?	Comment text
authorName	string?	Author’s display name
createdAt	datetime?	When the comment was posted (UTC)

ColumnValue Object

Provider-specific column data not covered by the standard Item fields.

Field	Type	Description
columnId	string	Column ID (matches Column.id from the board)
columnTitle	string	Column display name
type	string	Column type
text	string?	Human-readable text representation
value	string?	Raw provider JSON value (for programmatic use)

Field Visibility

The token's visibleTaskFields setting controls which Item fields are returned. Fields not in the mask are returned as null. The id, groupId, and groupName fields are structural and always included.

Flag	API String	Item Field Affected
Name	`name`	name
Status	`status`	status
Assignee	`assignee`	assignees
DueDate	`due_date`	dueDate
Priority	`priority`	priority
Labels	`labels`	labels
Description	`description`	description
Comments	`comments`	comments
SubItems	`sub_items`	subItems
ColumnValues	`column_values`	columnValues
All	`all`	All fields visible