Skip to main content
GET
List tasks

Authorizations

Authorization
string
header
required

JWT authentication token

Query Parameters

limit
integer
default:20

Number of tasks to return (max 100)

Required range: 1 <= x <= 100
starting_after
string<uuid>

Cursor for pagination - return tasks after this ID (newer)

ending_before
string<uuid>

Cursor for pagination - return tasks before this ID (older)

status
enum<string>

Filter by task status

Available options:
active,
completed,
error,
pending
is_scheduled
enum<string>

Filter by scheduled status. Defaults to 'false' when not provided, which hides scheduled-run tasks from the default list (each run of a schedule creates its own task). Pass 'true' to list only scheduled runs.

Available options:
true,
false
project_id
string<uuid>

Filter tasks by project ID. If omitted, returns only the current user's personal tasks.

Case-insensitive substring match on task title.

Maximum string length: 500
source
enum<string>

Filter by task source. Defaults to 'web' when not provided, which hides integration- and triage-sourced tasks from the default list. Pass a specific source to list only tasks from that origin.

Available options:
web,
github,
slack,
linear,
jira,
triage
visibility
enum<string>

Filter tasks by visibility. Tasks without explicit visibility are private.

Available options:
private,
unlisted,
team,
support
include_team_tasks
boolean
default:false

Include web tasks owned by current teammates when their visibility is team. In the personal task list, this always restricts the source to web, even if another source is supplied. Project-scoped lists ignore this option. Private, unlisted, and support tasks owned by teammates are never included.

order_by
enum<string>
default:updated_at

Field to sort tasks by. Defaults to updated_at so recently-active tasks surface first.

Available options:
created_at,
updated_at

Response

Task list with pagination info

has_more
boolean
required

Whether there are more results available

tasks
object[]
required
total
integer

Total number of tasks matching the current filters (ignores pagination cursor)