Skip to main content
GET
List tasks

Authorizations

Authorization
string
header
required

An org API key (gh_live_…) from Settings → API keys in the console.

Query Parameters

session_id
string

Only this session’s tasks.

agent_id
string

Only tasks run by this agent.

status
enum<string>

Only tasks with this status.

Available options:
queued,
running,
waiting_for_user,
waiting_for_approval,
completed,
failed,
stopped
limit
integer
default:20

How many to return, 1 to 100.

Required range: 1 <= x <= 100
cursor
string

next_cursor from the previous page.

Response

OK

data
object[]
required
has_more
boolean
required
next_cursor
string | null
required

Pass as cursor to get the next page.