Productions

Read a production

The production with its full brief, its timeline (events and comments, each with actorName), and its place in the render queue.

GET/v1/productions/{id}

API key with the productions scope.

Parameters

Field	In	Type	Description
`id`required	path	uuid	The production id.

Responses

200The production with its timeline.

400Invalid request.

401Missing, invalid or revoked key.

403The key lacks the scope, or the key's owner has view-only access to the workspace (code forbidden).

404Not found.

429Rate limited, or a monthly cap reached.

200 response body

Field	Type	Description
`production`required	object
`production.id`required	uuid
`production.workspaceId`required	uuid
`production.stage`required	enum	One of: `queued`, `writing_pitch`, `pitch_ready`, `greenlit`, `making`, `exporting`, `delivered`, `skipped`, `declined`, `cancelled`, `failed`
`production.source`required	object
`production.source.kind`required	enum	One of: `app`, `api`, `mcp`
`production.source.externalId`required	string \| null
`production.source.origin`	object \| null	Default `null`
`production.source.origin.provider`required	string
`production.source.origin.label`required	string
`production.source.origin.url`	url \| null	Default `null`
`production.source.origin.ref`	string \| null	Default `null`
`production.source.origin.requestedBy`	string \| null	Default `null`
`production.brief`required	object
`production.brief.intent`required	string
`production.brief.context`	string \| null	Default `null`
`production.brief.media`	object[]
`production.brief.media[].id`required	string
`production.brief.media[].kind`required	enum	One of: `image`, `video`
`production.brief.media[].url`required	url
`production.brief.media[].name`required	string
`production.brief.media[].description`	string \| null	Default `null`
`production.brief.code`	object[]
`production.brief.code[].path`required	string
`production.brief.code[].source`required	string
`production.brief.code[].status`	enum \| null	One of: `added`, `modified`, `removed`, `renamed`Default `null`
`production.brief.code[].additions`	integer	Default `0`
`production.brief.code[].deletions`	integer	Default `0`
`production.brief.code[].patch`	string \| null	Default `null`
`production.brief.code[].digest`	string \| null	Default `null`
`production.brief.code[].score`	number	Default `0`
`production.brief.code[].sourceOmitted`	boolean
`production.brief.format`	object
`production.brief.format.template`	enum	One of: `changelog`, `launch`, `feature`, `digest`, `custom`Default `changelog`
`production.brief.format.durationMs`	integer	Default `10000`
`production.brief.format.aspect`	enum	One of: `16:9`, `4:3`, `3:2`, `21:9`, `1:1`, `9:16`, `3:4`, `2:3`, `4:5`Default `16:9`
`production.brief.format.sound`	object
`production.brief.format.sound.voiceover`	boolean	Default `true`
`production.brief.format.sound.music`	boolean	Default `true`
`production.brief.format.sound.sfx`	boolean	Default `true`
`production.brief.brand`	object
`production.brief.brand.name`	string \| null	Default `null`
`production.brief.brand.logoUrl`	url \| null	Default `null`
`production.brief.brand.primaryColor`	string \| null	Default `null`
`production.brief.brand.backgroundColor`	string \| null	Default `null`
`production.brief.brand.fontFamily`	string \| null	Default `null`
`production.brief.brand.tone`	string \| null	Default `null`
`production.pitch`required	object \| null
`production.pitch.version`required	integer
`production.pitch.verdict`	enum	One of: `video`, `skip`Default `video`
`production.pitch.verdictReason`	string \| null	Default `null`
`production.pitch.title`required	string
`production.pitch.summary`required	string
`production.pitch.shots`required	object[]
`production.pitch.shots[].index`required	integer
`production.pitch.shots[].title`required	string
`production.pitch.shots[].durationMs`required	integer
`production.pitch.shots[].beat`	string \| null	Default `null`
`production.pitch.shots[].visual`required	string
`production.pitch.shots[].text`	string \| null	Default `null`
`production.pitch.shots[].voiceover`	string \| null	Default `null`
`production.pitch.shots[].mediaIds`	string[]
`production.pitch.shots[].codePaths`	string[]
`production.pitch.music`	string \| null	Default `null`
`production.pitch.estimatedCredits`required	integer
`production.pitch.createdAt`required	datetime
`production.greenlight`required	object \| null
`production.greenlight.mode`required	enum	One of: `manual`, `auto`
`production.greenlight.actor`required	string
`production.greenlight.actorName`	string \| null
`production.greenlight.at`required	datetime
`production.greenlight.pitchVersion`required	integer
`production.greenlightMode`required	enum	One of: `manual`, `auto`
`production.delivery`required	object \| null
`production.delivery.shareUrl`required	url
`production.delivery.projectId`required	uuid
`production.delivery.editUrl`required	url
`production.delivery.exportId`required	uuid
`production.delivery.deliveredAt`required	datetime
`production.projectId`required	uuid \| null
`production.creditsCharged`required	integer
`production.error`required	string \| null	Why the production failed, in words you can show a person. Never the render machine's own diagnostics.
`production.createdAt`required	datetime
`production.updatedAt`required	datetime
`production.terminal`	boolean	True once the stage is one the production never leaves (delivered, skipped, declined, cancelled, failed, or a terminal stage added later). Stop polling when it is true; it is computed by the server, so it stays right for stages your client does not know yet. Absent from payloads stored before the field existed.
`production.pageUrl`	url	The production's page in the Raylight app. Absent from payloads stored before the field existed.
`events`required	object[]
`events[].id`required	uuid
`events[].productionId`required	uuid
`events[].kind`required	enum	One of: `created`, `stage`, `pitch`, `comment`, `greenlit`, `declined`, `cancelled`, `delivered`, `failed`, `note`
`events[].actor`required	string
`events[].actorName`	string \| null	The name a person reads for `actor`: the user's name or email, the email behind a link, "Auto-greenlight", "Raylight", or null when unknown.
`events[].payload`required	object	The fields that kind of event carries for a reader: the stage, the comment, the credits charged or refunded, the error, your own `externalId` on `created`, and on a progress `note` the `phase` the production moved to. Nothing else is included.
`events[].createdAt`required	datetime
`queue`required	object \| null
`queue.phase`	enum \| any	Default `null`
`queue.startedAt`required	datetime \| null
`queue.retrying`	boolean	Default `false`
`queue.lastProgress`required	string \| null
`pitchMarkdown`required	string \| null

Example

curl

curl https://api.raylight.app/v1/productions/$ID \  -H "Authorization: Bearer $RAYLIGHT_API_KEY"