Canvases

Repair canvas preview media

Plans or starts a narrow repair for missing base WebM/HEVC derivatives on videos already assigned to this canvas. Agent workflow: first call with dry_run=true or omit dry_run because it defaults to true. Read status.media.preview, summary, repairs, in_flight, and skipped. If status.media.preview.waiting_edges > 0, wait and poll again instead of repairing. Only call again with dry_run=false if the repair plan matches the intended canvas videos. This endpoint is for the specific case where status.media.generation.ready=true, status.media.preview.ready=false, and status.media.preview.repairable=true. It does not regenerate animations, does not run mascot-wide jobs, does not create size variants, does not expose prompt/model controls, does not force regeneration, and does not archive existing assets.

post/v1/canvases/{canvasId}/repair

Request

  • Base URL: https://api.masko.ai
  • URL: https://api.masko.ai/v1/canvases/{canvasId}/repair
  • Auth: HTTP bearer

Path parameters

canvasIdstring uuid required

Headers

Idempotency-Keystring

Account-scoped key (1 to 255 characters, ideally a UUID). Retries must preserve the credential workspace, effective API version, URL, content type and exact body bytes, including multipart boundaries; different inputs return 409 idempotency_key_reused. Completed responses, including 500 errors, replay for 24 hours after completion with current resource access checked again. Running or unconfirmed executions return 409 idempotency_request_in_progress and do not expire automatically. A receipt persistence failure returns 503 idempotency_persistence_failed: retry only with the same key and inspect the operation outcome before starting a new request.

Request body

target'video_derivatives'

Repair target. Use video_derivatives when canvas status shows status.media.preview.repairable=true because completed edge videos are missing base WebM and/or HEVC child assets. If status.media.preview.waiting_edges > 0, wait and poll again instead of repairing. This target only repairs videos already assigned to the canvas graph.

formatsstring[]

Base derivative formats to repair. Defaults to both webm and hevc. This does not include size variants; optimized sizes must be generated through the size-variant flow.

dry_runboolean

When true, returns the exact repair plan without creating jobs or assets. Defaults to true. Agents should call dry_run=true first, inspect repairs/skipped/in_flight, then call dry_run=false only if the plan touches the intended videos.

Response

Repair plan returned

Changes

No recorded changes to this operation across all 1 revision of this API.