Delete scene by ID
Permanently delete a scene and all its associated data.
This action will delete:
- The scene and all its content
- All associated sharing links
- Scene version history
- Any cached or exported data
This action is irreversible. Once deleted, the scene cannot be recovered. Consider archiving or moving to a "trash" collection instead.
Deleting a scene will break any external links or integrations that reference this scene ID.
Use cases:
- Cleaning up unused or outdated scenes
- Implementing scene management workflows
- Bulk deletion operations
- Data retention compliance
Authorization
apiKey AuthorizationBearer <token>
The API will use the Authorization: Bearer <your-key> header for requests.
In: header
Path Parameters
sceneId*string
Response Body
application/json
application/json
application/json
application/json
curl -X DELETE "https://api.excalidraw.com/api/v1/scenes/string"{
"property1": null,
"property2": null
}{
"statusCode": 401,
"error": "Unauthorized",
"message": "string"
}{
"statusCode": 403,
"error": "Forbidden",
"message": "string"
}{
"statusCode": 404,
"error": "Not Found",
"message": "string"
}