---
title: "Get scene content"
method: GET
path: "/api/v1/scenes/{sceneId}/content"
tags: ["scenes", "scene-content"]
---

# Get scene content

`GET /api/v1/scenes/{sceneId}/content`

Retrieve the complete content of a scene including all drawing elements and files.

    This endpoint returns:
    - All drawing elements (shapes, lines, text, etc.)
    - Embedded files and images
    - Scene settings and configuration
    - Version information
    - Canvas state and viewport settings

    <Callout type="info">
    The response includes the current version of the scene. For version history or specific versions, use the versioning endpoints.
    </Callout>

    <Callout type="performance">
    Large scenes with many elements or files may result in substantial response sizes. Consider implementing client-side caching for frequently accessed scenes.
    </Callout>

    **Use cases:**
    - Loading scenes for editing
    - Creating scene backups
    - Exporting scene data
    - Scene analysis and processing

## Path parameters

- `sceneId` string, required

## Response `200`

This response returns the complete content of the requested scene.

- object — This response returns the complete content of the requested scene.
  - `type` 'excalidraw', required
  - `version` number, required
  - `source` string, required
  - `appState` object, required
    - `viewBackgroundColor` string, required
    - `lockedMultiSelections` object
  - `elements` unknown[], required
    - unknown
  - `sceneVersion` string, required
  - `files` object, required
  - `filesFailedToEmbed` string[] — List of file IDs referenced by the scene that could not be embedded into the response. Omitted when all referenced files were embedded successfully.

## Other responses

- `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.

---

[API](https://skmtc.net/excalidraw/apis/excalidraw-api.md) · [All operations](https://skmtc.net/excalidraw/apis/excalidraw-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/excalidraw/excalidraw-api/revisions/c1404d1545ba/schema)