Skip to main content
GET
List your team's async jobs

Authorizations

Authorization
string
header
required

HTTPBearer

Query Parameters

status
enum<string>[] | null

Job statuses to list. Repeatable. Defaults to pending and running.

Available options:
pending,
running,
succeeded,
failed,
cancelled
page_size
integer
default:200

Maximum rows per page.

Required range: 1 <= x <= 200
page_token
string | null

next_page_token from the previous page.

Maximum string length: 4096

Response

Successful Response

The body of GET /v2/async/jobs.

An object rather than a bare array, matching the rest of the v2 family, so a new field is not a shape change.

jobs
AsyncJobSummary · object[]
required

One page of the team's jobs, newest first.

next_page_token
string | null

Cursor for the next page, or null on the last one. Page until this is null, not until a short page — a page can be short, or empty, and still have more behind it. Valid only for the status filter it was returned with.