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."
}
Items
Delete Items by ID
Delete items by id within a namespace (up to 100 ids per request). Frees global quota.
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 innot_found_ids without failing the request. Deleting items frees global item quota immediately.
Path parameters
Headers
Body
curl -X POST "http://localhost:8080/namespaces/my-documents/items/delete" \
-H "Content-Type: application/json" \
-d '{
"ids": ["doc-1", "doc-2"]
}'
Response fields
{
"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: 0means none of the requested ids existed
Related
Was this page helpful?