Skip to main content
GET
List the current principal's videos
Returns the authenticated principal’s own videos, newest created_at first, through opaque cursor pagination. A video is either a character+motion Render (render_ prefix, created with Render Video (from Character and/or Motion)) or a MiniMax H3 text-to-video generation (vid_ prefix, created with Generate Video (from Text), First Frame, or First-Last Frames); the two sources are merged into one list by created_at. This endpoint replaces the retired GET /v1/renders.
GET /v1/renders no longer accepts GET — it now answers 405 Method Not Allowed, not 404, because POST /v1/renders is still registered on the same path. If your integration checked for a 404 to detect that the old route was gone, accept 405 too, or switch straight to this endpoint.

Request parameters

Response parameters

Returns 200 OK. A video summary deliberately carries no signed media URL and no failure detail — fetch Get Video for the full state.

Completion timing

On a Render-sourced item, completed_at can lag status reaching ready by up to roughly 30 seconds before it backfills — it isn’t a permanent gap. Decide whether a video is finished by checking status == "ready", not by whether completed_at is non-null.

Examples

To page through results, pass the previous response’s next_cursor as cursor on the next request; stop once has_more is false.

Next step

Use Get Video on any items[].id for the full state, including video_url.

Authorizations

Authorization
string
header
required

Server-side SDK clients use a project API key. Remote MCP clients use an OAuth access token. Never expose a project API key in browser code.

Headers

X-Request-Id
string

Optional caller-supplied correlation ID, up to 128 characters. The service returns the effective value in the response header for tracing and support.

Required string length: 1 - 128
X-Viggle-Source
string

Optional source-channel label, up to 128 characters, used to attribute traffic to an SDK, integration, product surface, or internal workflow.

Required string length: 1 - 128

Query Parameters

status
enum<string>

Optional lifecycle filter. When supplied, the page contains only videos whose current status exactly matches this value. The public lifecycle shared by every asynchronous resource. It carries the same values as RenderStatus.

Available options:
queued,
processing,
ready,
failed,
cancelled
cursor
string

Opaque continuation token from the previous page's next_cursor. Pass it unchanged and keep all other filters consistent while paging.

Required string length: 1 - 512
limit
integer
default:20

Maximum number of video summaries to return in one page, from 1 through 100. The default is 20.

Required range: 1 <= x <= 100

Response

One page of the principal's videos.

items
object[]
required

Video summaries in reverse chronological order for this page, merging Render-sourced and H3-sourced videos owned by the caller into one feed.

next_cursor
string | null
required

Opaque cursor for the next page; null when there is no later page. Pass it unchanged as the next cursor query value.

has_more
boolean
required

Whether another page is available after the current one.