List this tenant's renders
const url = 'https://example.com/v1/renders';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://example.com/v1/renders \ --header 'Authorization: Bearer <token>'List renders (final artifacts of succeeded compose/edit jobs), newest first — always scoped to the calling principal (client_id injected).
Phase C: the listing is driven by client_id (assets table); tenant_id
is included transitionally so pre-Phase-C renders (no asset row) can still
surface on the legacy path when studio falls back to it.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Header Parameters
Section titled “Header Parameters”Responses
Section titled “Responses”Successful Response
Paged GET /v1/renders response.
object
The page of renders, newest first.
One render — the final artifact of a succeeded compose / edit job.
The render’s identity IS the originating job’s ULID public_id. inputs
echoes the job’s request with raw S3 keys stripped upstream (presigned
*_image_url siblings stand in for them).
object
The originating job’s ULID public_id.
The originating job type (UPPER_SNAKE).
“compose” (product-to-model) or “edit” (swap).
Short-lived presigned GET URL for the final render image.
Job creation timestamp (UTC).
Page size that was applied.
Page offset that was applied.
Number of renders in this page.
Examplegenerated
{ "renders": [ { "public_id": "example", "job_type": "example", "origin": "example", "image_url": "example", "inputs": {}, "created_at": "2026-04-15T12:00:00Z" } ], "limit": 1, "offset": 1, "count": 1}Validation Error
object
object
Examplegenerated
{ "detail": [ { "loc": [ "example" ], "msg": "example", "type": "example" } ]}