Skip to main content
GET
List Tasks

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

order_by
string | null

Sort spec: created_at, type, app, or target_user, optionally followed by desc (e.g. created_at desc). Defaults to newest first.

expand
string[] | null

Fields to expand: actions, assignees.

page_token
string | null

Opaque cursor from a previous response's next_page_token. Omit to fetch the first page. Treat as opaque: do not decode, construct, or interpret it.

page_size
integer
default:100

Maximum number of items to return per page. Values above 100 are clamped to 100 rather than rejected.

Required range: x >= 1
type
string | null

Filter by task type.

category
string | null

Filter by task category. Ignored when type is passed.

status
string | null

Filter by task status.

product_area
string | null

Filter by product area.

search
string | null

Search string.

assigned_user_ids
string[] | null

Filter by assigned user IDs.

assigned_group_ids
string[] | null

Filter by assigned group IDs.

access_request_id
string | null

Filter by access request ID.

show_all_tasks
boolean
default:false

Show every task in your organization, not only the tasks assigned to you. Needs permission to view every task, such as the Admin role or a custom role that grants it.

Response

Successful Response

tasks
Task · object[]
required

The tasks in this page of results.

next_page_token
string | null

Token for the next page, or null when this is the last page. An absent token is the only end-of-results signal. A page holding fewer than page_size items does not mean the results are exhausted. Treat the value as opaque: do not decode, construct, or interpret it.