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 tenant (tenant_id server-injected).
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.
Example generated
{ "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
Example generated
{ "detail": [ { "loc": [ "example" ], "msg": "example", "type": "example" } ]}