Skip to main content
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": []
}

​
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

​
namespace_name
string
required
Namespace to delete from.

​
Headers

​
Content-Type
string
required
Must be application/json

​
Body

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

​
status
string
Request outcome. "success" when the delete request completed; "failure" on error.
​
message
string
Human-readable result or error description.
​
namespace_name
string
Namespace items were deleted from. Present on successful delete.
​
requested
number
Number of ids sent in the request. Present on successful delete.
​
deleted
number
Number of items actually removed. Present on successful delete.
​
not_found_ids
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": []
}

​
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