---
title: "Create a playlist"
method: POST
path: "/stacks"
tags: ["REST API"]
---

# Create a playlist

`POST /stacks`

## Request

- Base URL: `https://api.supercut.ai/v1`
- URL: `https://api.supercut.ai/v1/stacks`
- Auth: HTTP bearer

Works with: Personal token

Creates a playlist in the token's workspace, owned by the caller, and returns its public\_id for adding recordings. Note: Stacks have been renamed to Playlists across Supercut. The endpoint paths and payloads remain \`stacks\` for backwards compatibility.

## Request body

- object
  - `name` string, required
  - `description` string

## Response `201`

201

- object
  - `data` object, required
    - `public_id` string, required
    - `link` string, required: The playlist's page in the Supercut app that served the response, for the workspace members who can see it. `public_link` is its public page.
    - `name` string, required
    - `description` string, nullable, required
    - `created_at` string, required
    - `updated_at` string, required
    - `is_public` boolean, required: Deprecated: use `public_link`. Whether the stack has a public link.
    - `public_link` string, nullable, required
    - `workspace_access` 'VIEWER' | 'EDITOR', nullable, required
    - `sort` 'added_desc' | 'added_asc' | 'recorded_desc' | 'recorded_asc' | 'manual', required
    - `workspace_safename` string, required
    - `permission` 'VIEWER' | 'EDITOR' | 'ADMIN' | 'OWNER', required
    - `recording_count` number, required

## Other responses

- `400`: 400
- `401`: 401
- `402`: 402
- `403`: 403
- `404`: 404
- `409`: 409
- `429`: 429
- `500`: 500

---

[API](https://skmtc.dev/supercut/apis/supercut-platform-api.md) · [All operations](https://skmtc.dev/supercut/apis/supercut-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/supercut/apis/supercut-platform-api/revisions/66033895a858?raw)