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

Available options:
true,
false
project_id
string<uuid>

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

Search query for tasks. Behavior depends on search_type parameter.

Maximum string length: 500
search_type
enum<string>
default:title

Search type:

  • title: Case-insensitive substring match on task title (default)
  • semantic: AI-powered semantic search across task messages
Available options:
title,
semantic
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
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)