Skip to main content
DELETE
/
embeddings
/
delete
Delete Embeddings
curl --request DELETE \
  --url https://api.usecortex.ai/embeddings/delete \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "chunk_ids": [
    "CortexEmbeddings123_0",
    "CortexEmbeddings123_1"
  ],
  "tenant_id": "tenant_1234",
  "sub_tenant_id": "sub_tenant_4567"
}'
{
  "total_deleted": 1,
  "status": {},
  "success": true,
  "message": "Embeddings deleted successfully"
}
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.

​
Sample Request

curl --request DELETE \
  --url https://api.usecortex.ai/embeddings/delete \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "sub_tenant_id": ""
}'

​
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.

Body

application/json
​
chunk_ids
string[]
required

The chunk IDs of the source you want to delete

Example:
[
  "CortexEmbeddings123_0",
  "CortexEmbeddings123_1"
]
​
tenant_id
string
required

Unique identifier for the tenant/organization

Example:

"tenant_1234"

​
sub_tenant_id
string
default:""

Optional sub-tenant identifier used to organize data within a tenant. If omitted, the default sub-tenant created during tenant setup will be used.

Example:

"sub_tenant_4567"

Response

Successful Response

​
total_deleted
integer
required

Total number of embeddings that were successfully deleted

Example:

1

​
status
object
required

Dictionary mapping chunk IDs to their deletion status (true if deleted successfully). Example: {'chunk_1234': true}

​
success
boolean
default:true

Indicates whether the embeddings deletion operation completed successfully

Example:

true

​
message
string
default:Embeddings deleted successfully

Status message about the deletion operation

⌘I