List Tasks
List tasks visible to the current user.
Combine category, product_area, and status to scope results, e.g.
GET /v1/tasks?category=approval&product_area=appstore&status=pending. Pass
expand=actions or expand=assignees to hydrate those fields. Pass show_all_tasks=true to
see every task in your organization. It needs permission to view every task, such as the Admin
role or a custom role that grants it.
Cursor-paginated: pass the previous next_page_token back as page_token. Rely on
next_page_token being null for the last page — not on getting back a short page.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Sort spec: created_at, type, app, or target_user, optionally followed by desc (e.g. created_at desc). Defaults to newest first.
Fields to expand: actions, assignees.
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.
Maximum number of items to return per page. Values above 100 are clamped to 100 rather than rejected.
x >= 1Filter by task type.
Filter by task category. Ignored when type is passed.
Filter by task status.
Filter by product area.
Search string.
Filter by assigned user IDs.
Filter by assigned group IDs.
Filter by access request ID.
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
The tasks in this page of results.
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.