---
title: "Delete collection"
method: DELETE
path: "/api/v1/collections/{collectionId}"
tags: ["collections"]
---

# Delete collection

`DELETE /api/v1/collections/{collectionId}`

Soft-delete a collection by moving it to trash.

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

    **Use cases:**
    - Moving unused collections to trash
    - Implementing collection management workflows
    - Lifecycle management before permanent deletion

## Path parameters

- `collectionId` string, required

## Other responses

- `400` — This response indicates that the request was malformed or contained invalid parameters.
- `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)