Remakes

Report progress

The stage, the shot list as it stands, notes and the repair being run. Also the heartbeat: send one at least every 60 seconds. A remake with no progress for 15 minutes fails with cli_stopped and releases its project. 409 canceled means stop.

POST/v1/remakes/{id}/progress

API key with the remake scope.

Parameters

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

Request body

application/json

Field	Type	Description
`stage`required	enum	One of: `studying`, `building`, `polishing`, `needs_repair`
`shots`	object[]
`shots[].index`required	integer
`shots[].startMs`required	number
`shots[].durationMs`required	number
`shots[].state`required	enum	One of: `skeleton`, `building`, `built`, `failed`
`notes`	string[]
`repair`	object \| null
`repair.requested`required	boolean
`repair.uncovered`required	object[]
`repair.uncovered[].segmentId`required	string
`repair.uncovered[].firstMs`required	number
`repair.uncovered[].lastMs`required	number
`repair.uncovered[].box`required	object
`repair.uncovered[].box.x`required	number
`repair.uncovered[].box.y`required	number
`repair.uncovered[].box.w`required	number
`repair.uncovered[].box.h`required	number
`repair.uncovered[].samples`required	integer

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.

409The remake was canceled (code canceled) or already ended (code stage).

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/progress \  -H "Authorization: Bearer $RAYLIGHT_API_KEY" \  -H "Content-Type: application/json" \  -d '{  "stage": "studying"}'