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

namestring required
pinnedboolean required
collectionIdstring required

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 the details of the newly created scene.