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
string
required
Namespace to delete from.
Headers
string
required
Must be
application/jsonBody
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: 0means none of the requested ids existed
Related
Was this page helpful?