---
title: "Generate a draft variant reference"
method: POST
path: "/v1/collections/{id}/variants/{variantId}/reference"
tags: ["Collections"]
deprecated: true
---

# Generate a draft variant reference

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

## Request

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

> **Deprecated.**

Costs 1 credit. Uses the frozen source references and the requested variant description. Reuse operation_id to retry the same job. Poll the job, inspect candidates with GET variant, then approve the selected candidate.

## Path parameters

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

## Headers

- `Idempotency-Key` string

## Request body

- GenerateVariantReferenceBody
  - `operation_id` string, uuid, required: Client-generated UUID. Reuse to retry the same candidate job without another charge.

## Response `202`

Reference generation queued

- object
  - `data` object, required
    - `job_id` string, uuid, required
    - `candidate_id` string, uuid, required
    - `variant_id` string, uuid, required
    - `estimated_cost` number, required
    - `poll_url` string, required

## Other responses

- `400`: Invalid request or reference
- `401`: Authentication required
- `402`: Not enough credits
- `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)