moorcheh items-delete

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

Flag	Required	Description
`--namespace-name`	Yes	Namespace to delete from
`--ids-json`	Yes	JSON array of item id strings (max 100 per request)
`--base-url`	No	Default `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:

string

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

string

Human-readable result or error description.

string

Namespace items were deleted from.

number

Number of ids sent in the request.

number

Number of items actually removed.

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

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

Getting Started

Runtime

Namespace Management

Search

AI Generation

Data Operations

File storage

Items

Overview

Synopsis

Options

Examples

Output

Exit codes

​Overview

​Synopsis

​Options

​Examples

​Output

​Exit codes

​Related

Overview

Synopsis

Options

Examples

Output

Exit codes

Related