---
title: "Update collection settings"
method: PATCH
path: "/v1/collections/{id}/settings"
tags: ["Settings"]
deprecated: true
---

# Update collection settings

`PATCH /v1/collections/{id}/settings`

## Request

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

> **Deprecated.**

Updates mascot export settings. image_exports configures future PNG/WebP derivatives of original, transparent and sticker images; it does not backfill existing images. animation_sizes preserves existing behavior: changed settings may queue exports for existing animations as well as future outputs. Use POST /v1/mascots/{id}/exports for explicit image/video backfill, or the legacy size-variants endpoint for video-only repair. Returns settings_applied, size_variant_jobs and sizes_enabled. No credit cost.

## Path parameters

- `id` string, uuid, required

## Request body

- UpdateSettingsBody
  - `publish_params` object: Export settings. prores_exports enables original-size ProRes 4444 with alpha for future transparent animations. image_exports applies to future image completions. animation_sizes retains existing automatic video export behavior, including scheduling existing videos when settings change. Use POST /v1/mascots/:id/exports for explicit backfill.
    - `image_exports` object
      - `enabled` boolean, required
      - `sources` string[], required
      - `formats` string[], required
      - `sizes` integer[], required
    - `prores_exports` object: Automatically create original-delivery-size ProRes 4444 MOV files with alpha after transparent animations finish. Disabled by default.
      - `enabled` boolean, required
    - `animation_sizes` object
      - `enabled` boolean, required: Whether animation size variants are generated.
      - `sizes` number[], required: Pixel sizes to generate. Any integer from 32 to 1920. Common values: 720, 480, 360, 240.
  - `force_refresh` boolean

## Response `200`

Settings updated

- UpdatedFlagResponse
  - `data` UpdatedFlag, required
    - `updated` boolean, required
    - `slug` string

## 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/91eb3006a92f?raw)