Remakes

Resume a stopped remake

Reopens a remake that failed with cli_stopped or tab_lost within the last 24 hours: the project goes back to blank, every shot back to skeleton, and the project is held again. Rebuild from the local run, then attach.

POST/v1/remakes/{id}/resume

API key with the remake scope.

Parameters

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

Responses

200The reopened 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.

409The remake cannot be resumed (code stage), or another remake of yours is running (code remake_running).

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 -X POST https://api.raylight.app/v1/remakes/$ID/resume \  -H "Authorization: Bearer $RAYLIGHT_API_KEY"