Render frames in a compose session
Required permission: projects:write
API key auth. Prefix cf_live_ for production orgs, cf_test_ for sandbox.
In: header
Path Parameters
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/projects/string/compose-session/string/render" \ -H "Content-Type: application/json" \ -d '{ "timestamps": [ 0 ] }'null{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}{ "error": { "code": "string", "message": "string", "details": { "property1": null, "property2": null } }}Preview one component as a still in a compose session POST
Render a SINGLE org-installed component as one still inside the client's warm session box and return a presigned PNG URL. The component's authored tsxSource is read server-side (org-scoped) from the `componentId`; the box materializes and renders it. On a compile failure the response is a 422 `component_does_not_compile` carrying the sanitized compiler message — the authoring agent reads it to self-fix. A 422 `component_source_unavailable` means no authored source exists for the componentId in this org. The CLIENT owns the session lifecycle (open/close); this op neither opens nor closes a box.
Verify (score) a composition in a compose session POST
Score the composition with the server-side judge inside the warm session box: it samples the meaningful eval beats, renders them, and grades four criteria (editorial, spatial, brand, caption) returning per-criterion scores 0–10, a weighted composite, and a worst-first critique. Use the critique to fix the lowest criterion, then re-verify. The scoring rubric is server-side and never returned.