---
title: "Share a playlist with the workspace"
method: PUT
path: "/stacks/{public_id}/workspace-access"
tags: ["REST API"]
---

# Share a playlist with the workspace

`PUT /stacks/{public_id}/workspace-access`

## Request

- Base URL: `https://api.supercut.ai/v1`
- URL: `https://api.supercut.ai/v1/stacks/{public_id}/workspace-access`
- Auth: HTTP bearer

Works with: Personal token

Lets everyone in the workspace view or edit a playlist, or stops sharing it with the workspace. People and teams it is shared with individually keep their access. Note: Stacks have been renamed to Playlists across Supercut. The endpoint paths and payloads remain \`stacks\` for backwards compatibility.

## Path parameters

- `public_id` string, required

## Request body

- object
  - `access` 'VIEWER' | 'EDITOR', nullable, required

## Response `200`

200

- 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
    - `teams` object[], required
      - `team` object, required
        - `public_id` string, required
        - `name` string, required
      - `access` 'VIEWER' | 'EDITOR' | 'ADMIN', required
    - `users` object[]: Left out when the caller's workspace role can't list workspace members, since each entry carries an email.
      - `user` object, required
        - `public_id` string, required: Public user id, the same for this person everywhere.
        - `name` string, required
        - `avatar_url` string, nullable, required
        - `email` string, required
      - `access` 'VIEWER' | 'EDITOR' | 'ADMIN', 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)