---
title: "Export a canvas"
method: GET
path: "/v1/canvases/{canvasId}/export"
tags: ["Canvases"]
---

# Export a canvas

`GET /v1/canvases/{canvasId}/export`

## Request

- Base URL: `https://api.masko.ai`
- URL: `https://api.masko.ai/v1/canvases/{canvasId}/export`
- Auth: HTTP bearer

Exports the canvas as legacy MaskoAnimationConfig JSON by default, or as a target-specific delivery envelope with delivery=1. No credit cost.

## Path parameters

- `canvasId` string, uuid, required

## Query parameters

- `format` 'json'
- `delivery` '1': Return the delivery envelope instead of legacy MaskoAnimationConfig data.
- `target` 'macos' | 'windows' | 'web' | 'full': Delivery media target. macos returns HEVC URLs, windows returns WebM URLs, web returns WebM and HEVC URLs, full returns all selected formats.
- `mode` 'selected' | 'manifest': Delivery mode. selected returns one variant; manifest includes known variants.
- `size` integer: Selected delivery size in pixels, if that size variant has already been generated.

## Response `200`

Canvas export data

- ExportConfigResponse
  - `data` ExportConfigData, 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/84832e255613?raw)