scenes
Create new scene
Changed onCreate a new empty scene with specified metadata in a collection.
This endpoint creates a scene with:
- Basic metadata (name, pinned status)
- Assignment to a specific collection
- Empty content (no drawing elements)
- Default sharing settings
<Callout type="warn">
This endpoint only creates the scene structure and metadata. To add content (drawings, shapes, text), use the content endpoints after creation.
</Callout>
<Callout type="info">
The scene will be created with default permissions based on your workspace settings. Sharing links can be created separately with `PUT /scenes/:sceneId/link-sharing` and `PUT /scenes/:sceneId/shared-slides`.
</Callout>
**Use cases:**
- Creating scenes programmatically for templates
- Bulk scene creation for projects
- Integration with external project management tools
- Automated scene setup for teams
post/api/v1/scenes
Request
- Base URLhttps://api.excalidraw.com
- URLhttps://api.excalidraw.com/api/v1/scenes
- AuthHTTP bearer
Request body
Response
This response returns the details of the newly created scene.
Changes
- info
the request property
became optional
- info
- breaking
the response property
//became nullable for the status - breaking
the response property
//became nullable for the status
- breaking