---
title: "Create a named mascot variant"
method: POST
path: "/v1/collections/{id}/variants"
tags: ["Collections"]
deprecated: true
---

# Create a named mascot variant

`POST /v1/collections/{id}/variants`

## Request

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

> **Deprecated.**

Creates a draft from Original or source_variant_id. The source context and references are frozen. Supply reference_asset_id to use an existing collection image or your unassigned /v1/upload image and immediately approve the context, with no generation charge. Otherwise generate and approve a reference next. Reuse id for retries with the same inputs. This does not activate playback.

## Path parameters

- `id` string, uuid, required

## Headers

- `Idempotency-Key` string

## Request body

- CreateMascotVariantBody
  - `id` string, uuid, required: Client-generated UUID. Reuse it to safely retry creation.
  - `name` string, required
  - `description` string, required: The desired change and generation guidance.
  - `source_variant_id` string, uuid: Approved variant to start from. Omit for Original. Its references and context are frozen on creation.
  - `reference_asset_id` string, uuid: Completed image in this collection, or your unassigned POST /v1/upload image. Creates an approved context immediately; no generation charge. Omit to create a draft for reference generation.

## Response `201`

Created variant

- object
  - `data` MascotVariant, required
    - `id` string, uuid, required
    - `name` string, required
    - `description` string, required
    - `approved_at` string, nullable, required
    - `canvas_id` string, uuid, nullable, required
    - `reference_asset_id` string, uuid, nullable, required
    - `created_at` string, required

## Other responses

- `400`: Invalid request or reference
- `401`: Authentication required
- `403`: Variant creator required
- `404`: Collection, variant or reference not found
- `409`: Draft source, changed operation inputs, or candidate not ready

---

[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)