Skip to main content
POST
Delete Index
This action is irreversible. All items, vectors and metadata will be permanently lost.
Permanently delete an index and all its data.

Authentication

Required - admin (root) API key via X-API-Key header. Per-user (cdbk_) keys are rejected with 403 — a per-user credential operates on data, not index lifecycle:
When RBAC is not enabled (CYBORGDB_SERVICE_ROOT_KEY unset), no header is required.

Request Body

Response

Exceptions

Authentication failed (invalid API key) or wrong index_key on SDK-supplied indexes — see error model
Authenticated with a per-user (cdbk_) key — this operation requires the admin (root) API key
Index not found
Invalid request parameters
Internal server error

Example Usage

Confirmation Example

Data Removal

When an index is deleted, the following data is permanently removed:
  • Index structure: All index files and metadata
  • Vector embeddings: All stored vector data
  • Item contents: All associated content data
  • Metadata: All key-value metadata pairs
  • Training data: Any cached training information

Use Cases

  • Cleanup: Remove outdated or test indexes
  • Resource management: Free up storage and memory
  • Development lifecycle: Clean up development environments
  • Data governance: Remove indexes containing deprecated data