moorcheh items-get

Overview

Retrieves stored items by id within a namespace. Item ids are unique per namespace, not globally.

Text namespaces return id, text, and metadata
Vector namespaces return id and metadata only

Missing ids are omitted from items (still returns 200 with found_items less than requested_ids).

Synopsis

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

Options

Flag	Required	Description
`--namespace-name`	Yes	Namespace to read 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\",\"doc-2\"]'. In bash, use single quotes: '["doc-1","doc-2"]'.

Examples

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

moorcheh items-get --namespace-name my-embeddings --ids-json '["vec-1"]'

Output

Prints JSON from POST /namespaces/{namespace_name}/items/get:

string

"success" when the lookup completed; "failure" on error.

string

Human-readable result or error description.

number

Number of ids sent in the request.

number

Number of items returned in items.

array

Found items. Empty when none of the ids exist.

string

Item id.

string

Document text. Present for text namespace items only.

object

Metadata stored with the item.

Example output (text namespace)

{
  "status": "success",
  "message": "Successfully retrieved 1 items from namespace 'my-documents'.",
  "requested_ids": 2,
  "found_items": 1,
  "items": [
    {
      "id": "doc-1",
      "metadata": { "team": "ai" },
      "text": "CLI upload documents test"
    }
  ]
}

Example output (vector namespace)

{
  "status": "success",
  "message": "Successfully retrieved 1 items from namespace 'my-embeddings'.",
  "requested_ids": 1,
  "found_items": 1,
  "items": [
    {
      "id": "vec-1",
      "metadata": { "source": "demo" }
    }
  ]
}

Exit codes

Code	Meaning
`0`	Lookup completed (including when no ids were found)
`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