---
title: "List stacks"
method: GET
path: "/stacks"
tags: ["REST API"]
---

# List stacks

`GET /stacks`

## Request

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

Works with: Personal token Workspace token

List stacks visible in the workspace. Note: Stacks have been renamed to Playlists across Supercut. The endpoint paths and payloads remain \`stacks\` for backwards compatibility.

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

200

- object
  - `data` object, required
    - `items` 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
    - `next_cursor` string, nullable, 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)