Create a render from a published template
Requires a studio-owned API account with the print_orders:write key scope. Accepts explicit stable slot IDs only. Omit revision_id to resolve the latest published revision; the response snapshots the resolved immutable revision. The service does not infer input order or fetch arbitrary caller URLs. Convex durably queues this job; the local API does not embed or dispatch the private renderer.
Authorizations
Batch Relay scoped API key, not OAuth. Scope names document required key capabilities.
Headers
Retries with the same key return the durable render job; reuse with a different request returns idempotency_conflict.
1 - 200Path Parameters
1Body
A published one- or multi-surface output selector, such as print-8x10-portrait or trader-card-double-sided. It owns the selected surface variants.
Explicit stable slot ID to value mapping. Labels and positional order are never interpreted by the API.
Optional immutable template revision. When omitted, Batch Relay resolves the latest published revision and returns it in template.revision_id.
Response
Render queued, running, succeeded, or failed. Artifacts are always an array so multi-surface output is representable.