v36

latestOpenAPI 3.0.3GNU General Public License v3.0raw.githubusercontent.com2026-08-017758212.6 KB

workflow

List jobs with pagination and filtering

Retrieve a paginated list of jobs for the authenticated user. Returns lightweight job data optimized for list views. Workflow and full outputs are excluded to reduce payload size.

get/api/jobs

Query parameters

statusstring

Filter by one or more statuses (comma-separated). If not provided, returns all jobs.

workflow_idstring

Filter by workflow ID (exact match)

output_type'image' | 'video' | 'audio' | '3d'

Filter by output media type (only applies to completed jobs with outputs)

sort_by'create_time' | 'execution_time'

Field to sort by (create_time = when job was submitted, execution_time = how long workflow took to run)

sort_order'asc' | 'desc'

Sort direction (asc = ascending, desc = descending)

afterstring

Opaque cursor for keyset pagination. Pass the next_cursor value from a previous response to fetch the next page. Cursor pagination is supported only when sort_by=create_time (default). If sort_by=execution_time, after is ignored and offset/limit pagination is used. Cursors are opaque base64url payloads — clients should treat them as strings and not parse the contents.

offsetinteger

Pagination offset (0-based). Deprecated: prefer cursor-based pagination via after.

limitinteger

Maximum items per page (1-1000)

Response

Success - Jobs retrieved