---
title: "Delete your collection and its references only."
method: DELETE
path: "/api/collections/{collection_id}"
---

# Delete your collection and its references only.

`DELETE /api/collections/{collection_id}`

## Request

- Base URL: `https://okfindex.com`
- URL: `https://okfindex.com/api/collections/{collection_id}`
- Auth: none declared

Collections store references, not copied content. They start private. Owner search reads current files in owned bases and published files in other bases. Publication includes only references to currently public bases; private bases and later additions stay out. Every public read checks base publication again. Private or withdrawn collections return 404. Responses use private, no-store.
Returns: { removed }

## Path parameters

- `collection_id` string, required

## Response `200`

{ removed }

- object
  - `removed` boolean, required: True after deletion. Referenced bases and files are not deleted.

## Other responses

- `400`: Invalid name, cursor, query or idempotency key.
- `401`: A personal account or API key is required.
- `403`: Organization credentials cannot access personal collections.
- `404`: The collection or base is inaccessible.
- `409`: Collection or reference limit reached.
- `413`: Request body exceeds 2 KiB.
- `415`: Use application/json.
- `503`: Collection storage is unavailable.

---

[API](https://skmtc.dev/okfindex/apis/okf-index.md) · [All operations](https://skmtc.dev/okfindex/apis/okf-index/llms.txt) · [OpenAPI document](https://skmtc.dev/okfindex/apis/okf-index/revisions/4b13ca3c739f?raw)