---
title: "Delete scene by ID"
method: DELETE
path: "/api/v1/scenes/{sceneId}"
tags: ["scenes"]
---

# Delete scene by ID

`DELETE /api/v1/scenes/{sceneId}`

Soft-delete a scene by moving it to trash.

    This action will:
    - Remove the scene from active workspace lists
    - Move scene metadata to trash storage
    - Keep the item restorable from trash until it is permanently deleted via internal trash flows

    <Callout type="warn">
    This endpoint does not permanently delete the scene. It performs a trash move (soft delete).
    </Callout>

    <Callout type="warn">
    Existing links or integrations may stop working while the scene is in trash.
    </Callout>

    **Use cases:**
    - Moving unused or outdated scenes to trash
    - Implementing scene management workflows
    - Bulk soft-delete operations
    - Lifecycle management before permanent deletion

## Path parameters

- `sceneId` string, required

## Other responses

- `401` — This response indicates that the client must authenticate to access the requested resource.
- `403` — This response indicates that the client does not have permission to access the requested resource.
- `404` — This response indicates that the requested resource could not be found.

---

[API](https://skmtc.net/excalidraw/apis/excalidraw-api.md) · [All operations](https://skmtc.net/excalidraw/apis/excalidraw-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/excalidraw/excalidraw-api/revisions/c1404d1545ba/schema)