---
title: "Share presentation slides"
method: PUT
path: "/api/v1/scenes/{sceneId}/shared-slides"
tags: ["scenes"]
---

# Share presentation slides

`PUT /api/v1/scenes/{sceneId}/shared-slides`

## Request

- Base URL: `https://api.excalidraw.com`
- URL: `https://api.excalidraw.com/api/v1/scenes/{sceneId}/shared-slides`
- Auth: HTTP bearer

Turn the scene's shared presentation link on or off and return the link.

    Anyone with the link can step through the scene's frames as slides without signing in. The link is created the first time sharing is turned on and stays the same when it is turned off and on again.

    <Callout type="info">
    Each frame in the scene is one slide. Turning sharing on fails with 400 when the scene has no frames.
    </Callout>

    <Callout type="warn">
    Turning sharing on fails with 403 when a workspace admin has disabled scene sharing for the workspace.
    </Callout>

    **Use cases:**
    - Sending a presentation to an audience
    - Publishing slides alongside a talk
    - Revoking access to shared slides

## Path parameters

- `sceneId` string, required

## Request body

- object
  - `enabled` boolean, required: true to share the slides, false to turn the link off.

## Response `200`

This response returns whether the slides are shared, and their link.

- object: This response returns whether the slides are shared, and their link.
  - `enabled` boolean, required
  - `url` unknown, required

## Other responses

- `400`: This response indicates that the request was malformed or contained invalid parameters.
- `401`: This response indicates that the client must authenticate to access the requested resource.
- `403`: This response indicates that the client does not have permission to access the requested resource.
- `404`: This response indicates that the requested resource could not be found.

## Changes

- **2026-10-29** `9eecb866ae18`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/excalidraw/apis/excalidraw-api/changes/api/v1/scenes/:sceneId/shared-slides/put.md)

---

[API](https://skmtc.dev/excalidraw/apis/excalidraw-api.md) - [All operations](https://skmtc.dev/excalidraw/apis/excalidraw-api/llms.txt) - [OpenAPI document](https://skmtc.dev/excalidraw/apis/excalidraw-api/revisions/8a929c8cc5f5?raw)