Delete Embeddings

Delete embedding chunks by chunk ID.

Use this to remove specific chunks from your embeddings index when they are no longer valid or should not appear in results.

DELETE /embeddings/delete-raw-embeddings

Error

A valid request URL is required to generate request examples

200

{
  "delete_count": 1,
  "success": true,
  "error": "<string>"
}

Hit the Try it button to try this API now in our playground. It’s the best way to check the full request and response in one place, customize your parameters, and generate ready-to-use code snippets.

Examples

API Request

curl -X 'DELETE' \
'http://127.0.0.1:8080/embeddings/delete-raw-embeddings?tenant_id=tenant_123&sub_tenant_id=sub_tenant_345&source_id=source_123' \
-H 'accept: application/json'

TypeScript

const result = await client.embeddings.delete({
  tenant_id: "tenant_1234",
  sub_tenant_id: "sub_tenant_4567",
  chunk_ids: ["chunk_001", "chunk_002"]
});

Python (Sync)

# Async usage is similar, just use async_client and await
result = client.embeddings.delete(
    tenant_id="tenant_1234",
    sub_tenant_id="sub_tenant_4567",
    chunk_ids=["chunk_001", "chunk_002"]
)

Error Responses

All endpoints return consistent error responses following the standard format. For detailed error information, see our Error Responses documentation.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

tenant_id · string · required

Unique identifier for the tenant/organization

Example:

"tenant_1234"

sub_tenant_id · string | null

Optional sub-tenant ID for scoping deletion

Example:

"sub_tenant_4567"

source_id · string | null

Optional source ID to delete by (mutually exclusive with chunk_ids)

Example:

"CortexDoc1234"

chunk_ids · string[] | null

Optional list of chunk IDs to delete (mutually exclusive with source_id)

Example:

[
  "CortexEmbeddings123_0",
  "CortexEmbeddings123_1"
]

Response

200

application/json

Successful Response

Result of a delete operation.

delete_count · integer · required

Number of entities deleted

Example:

1

success · boolean · default: true

Whether delete succeeded

Example:

true

error · string | null

Error message if failed