Skip to main content
POST
List tasks

Body

application/json
agent
string

Filter by assigned agent

all
boolean

Include archived and visible tasks

allTime
boolean

Disable the default 1d updated_at window

archived
boolean

List only archived tasks

cursor
string

Opaque cursor returned by the previous page

last
string

Number of newest tasks to show by default (default: 30; use 0 or "all" to disable)

limit
string

Page size (default: 30, max: 500)

mine
boolean

Filter by current agent/session context

order
string

Sort direction: asc|desc

parent
string

Filter direct children of one parent task

profile
string

Filter by task profile

root
string

Filter one task tree (root task plus descendants)

roots
boolean

Show only root tasks (no parent)

session
string

Filter by assigned session

since
string

Lower updated_at bound: 1d, epoch ms, or ISO datetime

sort
string

Sort field: updated|created

status
string

Filter by status

tag
string

Filter by canonical task tag

text
string

Free-text match across id, title, instructions, summary, blocker, profile, agent and session

until
string

Upper updated_at bound: 1d, epoch ms, or ISO datetime

Response

Success — no @Returns schema declared; payload shape is loose.

The response is of type object.