Settings

Backfill animation size variants

Starts idempotent jobs for missing animation size variants on completed videos in this collection. Normal pipeline usage sends {}: it uses the collection configured animation_sizes, or [360] when no sizes are configured, and only creates missing variants. force=true is an explicit admin recovery option that regenerates existing variants too; do not use it for normal marketplace/canvas backfills or while relevant jobs are in flight. This endpoint does not regenerate source animations and does not toggle collection settings.

post/v1/collections/{id}/size-variants

Request

  • Base URL: https://api.masko.ai
  • URL: https://api.masko.ai/v1/collections/{id}/size-variants
  • Auth: HTTP bearer

Path parameters

idstring 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

sizesinteger[]

Sizes to generate. Defaults to the collection's configured animation_sizes, or [360].

forceboolean

Regenerate even sizes that already exist. Default false (idempotent: only missing sizes, never supersedes in-flight jobs).

Response

Size variant jobs started

Changes

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