> ## 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.

# moorcheh items-delete

> Delete items by id within a namespace.

## 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

```bash theme={null}
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`                         |

<Note>
  On **Windows PowerShell**, escape inner quotes: `--ids-json '[\"doc-1\"]'`. In bash, use single quotes: `'["doc-1"]'`.
</Note>

## Examples

```bash theme={null}
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`:

<ResponseField name="status" type="string">
  `"success"` when the delete request completed; `"failure"` on error.
</ResponseField>

<ResponseField name="message" type="string">
  Human-readable result or error description.
</ResponseField>

<ResponseField name="namespace_name" type="string">
  Namespace items were deleted from.
</ResponseField>

<ResponseField name="requested" type="number">
  Number of ids sent in the request.
</ResponseField>

<ResponseField name="deleted" type="number">
  Number of items actually removed.
</ResponseField>

<ResponseField name="not_found_ids" type="array">
  Ids that were not found (may be empty).
</ResponseField>

```json Example output (success) theme={null}
{
  "status": "success",
  "message": "Delete by ids completed.",
  "namespace_name": "my-documents",
  "requested": 1,
  "deleted": 1,
  "not_found_ids": []
}
```

```json Example output (none found) theme={null}
{
  "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` |

## Related

* [CLI: items-get](/on-prem/cli/items/get)
* [API: Delete items](/on-prem/api-references/items/delete)
* [Python: documents.delete()](/on-prem/python-client/items/delete)