---
title: "Backfill animation size variants"
method: POST
path: "/v1/collections/{id}/size-variants"
tags: ["Settings"]
deprecated: true
---

# Backfill animation size variants

`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

> **Deprecated.**

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.

## Path parameters

- `id` string, uuid, required

## Headers

- `Idempotency-Key` string

## Request body

- GenerateSizeVariantsBody
  - `sizes` integer[]: Sizes to generate. Defaults to the collection's configured animation_sizes, or [360].
  - `force` boolean: Regenerate even sizes that already exist. Default false (idempotent: only missing sizes, never supersedes in-flight jobs).

## Response `200`

Size variant jobs started

- SizeVariantsResponse
  - `data` SizeVariantsData, required
    - `size_variant_jobs` integer, required
    - `sizes` integer[], required
    - `force` boolean, required

## Other responses

- `400`: Validation error
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict

---

[API](https://skmtc.dev/masko/apis/masko-api.md) · [All operations](https://skmtc.dev/masko/apis/masko-api/llms.txt) · [OpenAPI document](https://skmtc.dev/masko/apis/masko-api/revisions/91eb3006a92f?raw)