Remakes

Read a remake

The remake with its shots as they build, the repair the CLI is running, the report once done, whether a builder tab is attached, and the project link.

GET/v1/remakes/{id}

API key with the remake scope.

Parameters

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

Responses

200The remake.

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
`remake`required	object
`remake.id`required	uuid
`remake.status`required	enum	The furthest stage reached: studying (the study runs on your machine), building (shots land in the project as they are built; overlaps studying), polishing (the film-wide pass), needs_repair (the CLI is running the repair session), then done, failed or canceled. New values may be added; treat unknown ones as opaque.One of: `studying`, `building`, `polishing`, `needs_repair`, `done`, `failed`, `canceled`
`remake.projectId`required	uuid \| null
`remake.projectUrl`required	url \| null
`remake.shots`required	object[]
`remake.shots[].index`required	integer
`remake.shots[].startMs`required	number
`remake.shots[].durationMs`required	number
`remake.shots[].state`required	enum	One of: `skeleton`, `building`, `built`, `failed`
`remake.repair`required	object \| null
`remake.repair.requested`required	boolean
`remake.repair.uncovered`required	object[]
`remake.repair.uncovered[].segmentId`required	string
`remake.repair.uncovered[].firstMs`required	number
`remake.repair.uncovered[].lastMs`required	number
`remake.repair.uncovered[].box`required	object
`remake.repair.uncovered[].box.x`required	number
`remake.repair.uncovered[].box.y`required	number
`remake.repair.uncovered[].box.w`required	number
`remake.repair.uncovered[].box.h`required	number
`remake.repair.uncovered[].samples`required	integer
`remake.report`required	object \| null
`remake.report.glitches`required	any[]
`remake.report.gaps`required	any[]
`remake.report.notes`required	string[]
`remake.error`required	string \| null
`remake.errorCode`required	enum \| null	One of: `cli_stopped`, `tab_lost`, `study_error`, `build_error`
`remake.libraryEligible`required	boolean	Whether this remake (the video, the study and the plan applied) may feed Raylight's motion library. False once the owner or the workspace turns data sharing off (Settings, Improve Raylight); that switch is the only opt-out.
`remake.source`required	object
`remake.source.fileName`required	string
`remake.source.durationMs`required	integer
`remake.source.width`required	integer
`remake.source.height`required	integer
`remake.source.fps`required	number
`remake.agent`required	enum	One of: `claude`, `codex`
`remake.builder`required	object
`remake.builder.attached`required	boolean
`remake.builder.lastSeenAt`required	string \| null
`remake.createdAt`required	string
`remake.updatedAt`required	string

Example

curl

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