Productions

List productions

Newest first. Pass externalId to find the production an earlier create with that id made (the same match a repeated create replays), for example to check whether a pull request already has one before sending its brief again. Every code file in each brief has source and patch emptied and carries sourceOmitted: true; read one production for its full files.

GET/v1/productions

API key with the productions scope.

Parameters

Field	In	Type
`workspaceId`	query	uuid
`stage`	query	string
`limit`	query	integer
`externalId`	query	string

Responses

200Productions, newest first.

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
`productions`required	object[]
`productions[].id`required	uuid
`productions[].workspaceId`required	uuid
`productions[].stage`required	enum	One of: `queued`, `writing_pitch`, `pitch_ready`, `greenlit`, `making`, `exporting`, `delivered`, `skipped`, `declined`, `cancelled`, `failed`
`productions[].source`required	object
`productions[].source.kind`required	enum	One of: `app`, `api`, `mcp`
`productions[].source.externalId`required	string \| null
`productions[].source.origin`	object \| null	Default `null`
`productions[].source.origin.provider`required	string
`productions[].source.origin.label`required	string
`productions[].source.origin.url`	url \| null	Default `null`
`productions[].source.origin.ref`	string \| null	Default `null`
`productions[].source.origin.requestedBy`	string \| null	Default `null`
`productions[].brief`required	object
`productions[].brief.intent`required	string
`productions[].brief.context`	string \| null	Default `null`
`productions[].brief.media`	object[]
`productions[].brief.media[].id`required	string
`productions[].brief.media[].kind`required	enum	One of: `image`, `video`
`productions[].brief.media[].url`required	url
`productions[].brief.media[].name`required	string
`productions[].brief.media[].description`	string \| null	Default `null`
`productions[].brief.code`	object[]
`productions[].brief.code[].path`required	string
`productions[].brief.code[].source`required	string
`productions[].brief.code[].status`	enum \| null	One of: `added`, `modified`, `removed`, `renamed`Default `null`
`productions[].brief.code[].additions`	integer	Default `0`
`productions[].brief.code[].deletions`	integer	Default `0`
`productions[].brief.code[].patch`	string \| null	Default `null`
`productions[].brief.code[].digest`	string \| null	Default `null`
`productions[].brief.code[].score`	number	Default `0`
`productions[].brief.code[].sourceOmitted`	boolean
`productions[].brief.format`	object
`productions[].brief.format.template`	enum	One of: `changelog`, `launch`, `feature`, `digest`, `custom`Default `changelog`
`productions[].brief.format.durationMs`	integer	Default `10000`
`productions[].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`
`productions[].brief.format.sound`	object
`productions[].brief.format.sound.voiceover`	boolean	Default `true`
`productions[].brief.format.sound.music`	boolean	Default `true`
`productions[].brief.format.sound.sfx`	boolean	Default `true`
`productions[].brief.brand`	object
`productions[].brief.brand.name`	string \| null	Default `null`
`productions[].brief.brand.logoUrl`	url \| null	Default `null`
`productions[].brief.brand.primaryColor`	string \| null	Default `null`
`productions[].brief.brand.backgroundColor`	string \| null	Default `null`
`productions[].brief.brand.fontFamily`	string \| null	Default `null`
`productions[].brief.brand.tone`	string \| null	Default `null`
`productions[].pitch`required	object \| null
`productions[].pitch.version`required	integer
`productions[].pitch.verdict`	enum	One of: `video`, `skip`Default `video`
`productions[].pitch.verdictReason`	string \| null	Default `null`
`productions[].pitch.title`required	string
`productions[].pitch.summary`required	string
`productions[].pitch.shots`required	object[]
`productions[].pitch.shots[].index`required	integer
`productions[].pitch.shots[].title`required	string
`productions[].pitch.shots[].durationMs`required	integer
`productions[].pitch.shots[].beat`	string \| null	Default `null`
`productions[].pitch.shots[].visual`required	string
`productions[].pitch.shots[].text`	string \| null	Default `null`
`productions[].pitch.shots[].voiceover`	string \| null	Default `null`
`productions[].pitch.shots[].mediaIds`	string[]
`productions[].pitch.shots[].codePaths`	string[]
`productions[].pitch.music`	string \| null	Default `null`
`productions[].pitch.estimatedCredits`required	integer
`productions[].pitch.createdAt`required	datetime
`productions[].greenlight`required	object \| null
`productions[].greenlight.mode`required	enum	One of: `manual`, `auto`
`productions[].greenlight.actor`required	string
`productions[].greenlight.actorName`	string \| null
`productions[].greenlight.at`required	datetime
`productions[].greenlight.pitchVersion`required	integer
`productions[].greenlightMode`required	enum	One of: `manual`, `auto`
`productions[].delivery`required	object \| null
`productions[].delivery.shareUrl`required	url
`productions[].delivery.projectId`required	uuid
`productions[].delivery.editUrl`required	url
`productions[].delivery.exportId`required	uuid
`productions[].delivery.deliveredAt`required	datetime
`productions[].projectId`required	uuid \| null
`productions[].creditsCharged`required	integer
`productions[].error`required	string \| null	Why the production failed, in words you can show a person. Never the render machine's own diagnostics.
`productions[].createdAt`required	datetime
`productions[].updatedAt`required	datetime
`productions[].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.
`productions[].pageUrl`	url	The production's page in the Raylight app. Absent from payloads stored before the field existed.

Example

curl

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