scenes

Get scene metadata

Changed on

Retrieve detailed metadata for a specific scene by its ID.

This endpoint returns:
- Complete scene metadata (name, dates, pinned status)
- All associated read-only sharing links
- All shared slides presentation links
- Collection assignment information

<Callout type="info">
This endpoint only returns metadata. To get the actual scene content (drawings, shapes, etc.), use the content endpoint.
</Callout>

**Use cases:**
- Displaying scene information in UI
- Checking scene permissions and sharing status
- Building scene detail views
- Validating scene existence before operations
get/api/v1/scenes/{sceneId}

Request

  • Base URL
    https://api.excalidraw.com
  • URL
    https://api.excalidraw.com/api/v1/scenes/{sceneId}
  • Auth
    HTTP bearer

Path parameters

sceneIdstring required

Response

This response returns the metadata for the requested scene.

Changes

    • breaking

      the response property // became nullable for the status

    • breaking

      the response property // became nullable for the status

    • warning

      removed the optional property / from the response with the status