Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.moorcheh.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Deletes one or more items by id within a namespace. Missing ids are listed in not_found_ids without failing the request. Deleting items frees global item quota immediately. Maximum 100 ids per request.

​
Synopsis

moorcheh items-delete --namespace-name NAME --ids-json '["id1"]' [--base-url URL]

​
Options

FlagRequiredDescription
--namespace-nameYesNamespace to delete from
--ids-jsonYesJSON array of item id strings (max 100 per request)
--base-urlNoDefault http://localhost:8080
On Windows PowerShell, escape inner quotes: --ids-json '[\"doc-1\"]'. In bash, use single quotes: '["doc-1"]'.

​
Examples

moorcheh items-delete --namespace-name my-documents --ids-json '["doc-1"]'

moorcheh items-delete --namespace-name my-documents --ids-json '["doc-1","doc-2"]'

​
Output

Prints JSON from POST /namespaces/{namespace_name}/items/delete:
​
status
string
"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.
​
requested
number
Number of ids sent in the request.
​
deleted
number
Number of items actually removed.
​
not_found_ids
array
Ids that were not found (may be empty).
Example output (success)
{
  "status": "success",
  "message": "Delete by ids completed.",
  "namespace_name": "my-documents",
  "requested": 1,
  "deleted": 1,
  "not_found_ids": []
}
Example output (none found)
{
  "status": "success",
  "message": "Delete by ids completed.",
  "namespace_name": "my-documents",
  "requested": 2,
  "deleted": 0,
  "not_found_ids": ["doc-missing", "another-missing"]
}

​
Exit codes

CodeMeaning
0Delete completed (including when deleted is 0)
1API error (400, 404, 500, etc.) or invalid --ids-json