Delete Items by ID

curl -X POST "http://localhost:8080/namespaces/my-documents/items/delete" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": ["doc-1", "doc-2"]
  }'

{
  "status": "success",
  "message": "Delete by ids completed.",
  "namespace_name": "my-documents",
  "requested": 1,
  "deleted": 1,
  "not_found_ids": []
}

{
  "status": "success",
  "message": "Delete by ids completed.",
  "namespace_name": "my-documents",
  "requested": 2,
  "deleted": 1,
  "not_found_ids": ["doc-missing"]
}

{
  "status": "success",
  "message": "Delete by ids completed.",
  "namespace_name": "my-documents",
  "requested": 2,
  "deleted": 0,
  "not_found_ids": ["doc-missing", "another-missing"]
}

{
  "status": "failure",
  "message": "Bad Request: ids must be a non-empty array."
}

{
  "status": "failure",
  "message": "Bad Request: at most 100 ids are allowed per delete request."
}

{
  "status": "failure",
  "message": "Bad Request: each id must be a non-empty string."
}

{
  "status": "failure",
  "message": "Namespace 'my-documents' not found."
}

{
  "status": "failure",
  "message": "Internal Server Error deleting namespace documents."
}

POST

namespaces

{namespace_name}

items

delete

curl -X POST "http://localhost:8080/namespaces/my-documents/items/delete" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": ["doc-1", "doc-2"]
  }'

{
  "status": "success",
  "message": "Delete by ids completed.",
  "namespace_name": "my-documents",
  "requested": 1,
  "deleted": 1,
  "not_found_ids": []
}

{
  "status": "success",
  "message": "Delete by ids completed.",
  "namespace_name": "my-documents",
  "requested": 2,
  "deleted": 1,
  "not_found_ids": ["doc-missing"]
}

{
  "status": "success",
  "message": "Delete by ids completed.",
  "namespace_name": "my-documents",
  "requested": 2,
  "deleted": 0,
  "not_found_ids": ["doc-missing", "another-missing"]
}

{
  "status": "failure",
  "message": "Bad Request: ids must be a non-empty array."
}

{
  "status": "failure",
  "message": "Bad Request: at most 100 ids are allowed per delete request."
}

{
  "status": "failure",
  "message": "Bad Request: each id must be a non-empty string."
}

{
  "status": "failure",
  "message": "Namespace 'my-documents' not found."
}

{
  "status": "failure",
  "message": "Internal Server Error deleting namespace documents."
}

Overview

Delete one or more items by id within a namespace. Item ids are unique per namespace, not globally. Missing ids are listed in not_found_ids without failing the request. Deleting items frees global item quota immediately.

Path parameters

string

required

Namespace to delete from.

Headers

string

required

Must be application/json

Body

array

required

Non-empty array of item id strings. Maximum 100 ids per request.

curl -X POST "http://localhost:8080/namespaces/my-documents/items/delete" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": ["doc-1", "doc-2"]
  }'

Response fields

string

Request outcome. "success" when the delete request completed; "failure" on error.

string

Human-readable result or error description.

string

Namespace items were deleted from. Present on successful delete.

number

Number of ids sent in the request. Present on successful delete.

number

Number of items actually removed. Present on successful delete.

array

Ids that were not found in the namespace. Present on successful delete (may be empty).

{
  "status": "success",
  "message": "Delete by ids completed.",
  "namespace_name": "my-documents",
  "requested": 1,
  "deleted": 1,
  "not_found_ids": []
}

{
  "status": "success",
  "message": "Delete by ids completed.",
  "namespace_name": "my-documents",
  "requested": 2,
  "deleted": 1,
  "not_found_ids": ["doc-missing"]
}

{
  "status": "success",
  "message": "Delete by ids completed.",
  "namespace_name": "my-documents",
  "requested": 2,
  "deleted": 0,
  "not_found_ids": ["doc-missing", "another-missing"]
}

{
  "status": "failure",
  "message": "Bad Request: ids must be a non-empty array."
}

{
  "status": "failure",
  "message": "Bad Request: at most 100 ids are allowed per delete request."
}

{
  "status": "failure",
  "message": "Bad Request: each id must be a non-empty string."
}

{
  "status": "failure",
  "message": "Namespace 'my-documents' not found."
}

{
  "status": "failure",
  "message": "Internal Server Error deleting namespace documents."
}

Important Notes

Works for both text and vector namespaces
Deleting items frees quota toward the global 100,000 item limit
A 200 response with deleted: 0 means none of the requested ids existed

System

Namespace Management

Search

AI Generation

Data Operations

File storage

Items

Overview

Path parameters

Headers

Body

Response fields

Important Notes

​Overview

​Path parameters

​Headers

​Body

​Response fields

​Important Notes

​Related

Overview

Path parameters

Headers

Body

Response fields

Important Notes

Related