---
title: "Approve a generated variant reference"
method: POST
path: "/v1/mascots/{id}/variants/{variantId}/approve"
tags: ["Mascots"]
---

# Approve a generated variant reference

`POST /v1/mascots/{id}/variants/{variantId}/approve`

## Request

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

Select a completed candidate belonging to this variant. Creates its canvas and makes variant_id usable for generation. Does not generate poses or change active playback. Repeating approval of the same candidate is safe.

## Path parameters

- `id` string, uuid, required
- `variantId` string, uuid, required

## Headers

- `Idempotency-Key` string

## Request body

- ApproveMascotVariantBody
  - `candidate_id` string, uuid, required: Completed candidate from this variant to use as its reference.

## Response `200`

Approved 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`: Mascot, 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/84832e255613?raw)