---
title: "Generate a follow-cursor interaction"
method: POST
path: "/v1/collections/{id}/interactive"
tags: ["Generate"]
deprecated: true
---

# Generate a follow-cursor interaction

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

## Request

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

> **Deprecated.**

Creates nine 1024×1024 transparent gaze directions from one completed image. Requires a completed transparent source or transparent derivative in the same collection. Preserves the source variant automatically; no variant_id override. Optional name (maximum 60 characters after trimming) labels only the interaction; omitted or blank names use the source image name without renaming the image. Costs 9 credits. Returns an asynchronous job receipt. Send once and poll the returned job URL; repeating POST creates and charges a new set. Hosted collections automatically publish a JSON manifest and nine lossless WebPs. Retrieve them with GET /v1/collections/{id}/cdn-export after completion. This interaction is independent of Canvas state machines.

## Path parameters

- `id` string, uuid, required

## Headers

- `Idempotency-Key` string

## Request body

- CreateInteractionBody
  - `source_asset_id` string, uuid, required
  - `kind` 'cursor-follower', required
  - `name` string: Interaction label. Omitted or blank names use the source image name without renaming the image.

## Response `202`

Nine-direction generation queued

- InteractionGenerationResponse
  - `data` object, required
    - `job_id` string, uuid, required
    - `asset_id` string, uuid, required
    - `asset_ids` object, required
      - `interactive` string, uuid, required
    - `status` 'pending', required
    - `estimated_cost` number, required
    - `variant_id` string, uuid, nullable, required
    - `poll_url` string, required

## Other responses

- `400`: Invalid request
- `401`: Unauthorized
- `402`: Insufficient credits
- `403`: Write access required
- `404`: Collection or completed source not found
- `422`: Transparent image required
- `429`: Rate limited
- `500`: Could not queue generation

---

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