latestOpenAPI 3.0.02026-08-08270135.7 KB
c1404d1545ba
scenes
Create new scene
Create 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 using the links endpoints.
</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 body
Response
This response returns the details of the newly created scene.