Skip to main content
GET
List Video Generations

Authorizations

Authorization
string
header
required

Enter your MeshAPI key (rsk_...) — sent as Authorization: Bearer <key>.

Headers

X-Mesh-Version
enum<string>
default:2026-08

Dated version of the API contract to pin this request to. Omit it and the request is served under 2026-08 — the oldest supported version, so an existing integration is never moved by a release. A malformed or unsupported value is rejected with 400 invalid_api_version rather than falling back silently. The version actually served is echoed as X-Mesh-Version on every response, including errors.

Available options:
2026-08

Query Parameters

status
enum<string>[] | null

Filter by one or more task statuses, e.g. ?status=running&status=failed

Available options:
queued,
running,
cancelled,
succeeded,
failed,
expired
model
string[] | null

Filter by one or more MeshAPI model ids

created_after
string<date-time> | null

Only include tasks created at or after this ISO 8601 timestamp

created_before
string<date-time> | null

Only include tasks created before this ISO 8601 timestamp

limit
integer
default:50
Required range: 1 <= x <= 200
offset
integer
default:0
Required range: x >= 0

Response

Persisted video generation tasks for the authenticated owner

data
VideoTaskResponse · object[]
required
has_more
boolean
required
total
integer
required
limit
integer
required
offset
integer
required
object
string
default:list
Allowed value: "list"