scenes
Get all scenes
Changed onRetrieve a paginated list of scenes with their metadata and associated links.
This endpoint allows you to:
- Get all scenes in your workspace
- Filter scenes by collection ID
- Paginate through large sets of scenes
- Access read-only and shared slides links for each scene
<Callout type="info">
Scenes are returned with their complete metadata including creation/modification dates, pinned status, and associated sharing links.
</Callout>
**Use cases:**
- Building a scene browser or gallery
- Syncing scenes with external systems
- Creating scene management dashboards
- Implementing search and filter functionality
get/api/v1/scenes
Request
- Base URLhttps://api.excalidraw.com
- URLhttps://api.excalidraw.com/api/v1/scenes
- AuthHTTP bearer
Query parameters
limitinteger
The number of items to return per page.
offsetinteger
The number of items to skip before starting to collect the result set.
collectionIdstring
Collection ID. Personal API keys may use 'private' for the key owner's virtual private collection. Workspace API keys cannot access private collections.
Response
This response returns a paginated list of all scenes.
Changes
- breaking
the response property
////became nullable for the status - breaking
the response property
////became nullable for the status
- breaking
- warning
removed the optional property
///from the response with the status
- warning