Remakes

Finish a remake

Stores the report, ends the hold and releases the builder tab. The project is yours to edit.

POST/v1/remakes/{id}/complete

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
`report`required	object
`report.glitches`required	any[]
`report.gaps`required	any[]
`report.notes`required	string[]

Responses

200The finished 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 is not at a stage that takes this call, or it 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/complete \  -H "Authorization: Bearer $RAYLIGHT_API_KEY" \  -H "Content-Type: application/json" \  -d '{  "report": {    "glitches": [      "<glitches>"    ],    "gaps": [      "<gaps>"    ],    "notes": [      "<notes>"    ]  }}'