Delete scene by ID

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

This endpoint does not permanently delete the scene. It performs a trash move (soft delete).

Existing links or integrations may stop working while the scene is in trash.

Use cases:

Authorization

apiKey

AuthorizationBearer <token>

The API will use the Authorization: Bearer <your-key> header for requests.

In: header

sceneId*string

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"
}