Skip to main content

​
Overview

Lists every namespace on this Moorcheh instance with type, item count, vector dimension, and created time. Prints JSON to stdout.

​
Synopsis

moorcheh namespace-list [--base-url URL]

​
Options

FlagDefaultDescription
--base-urlhttp://localhost:8080Moorcheh API base URL

​
Examples

moorcheh namespace-list

moorcheh namespace-list --base-url http://localhost:8081

​
Output

Prints JSON from GET /namespaces:
​
namespaces
array
List of namespace objects. Empty array when no namespaces exist.
​
namespaces[].namespace_name
string
Unique namespace name.
​
namespaces[].type
string
"text" or "vector".
​
namespaces[].vector_dimension
number | null
Vector dimension for vector namespaces; null for text.
​
namespaces[].item_count
number
Number of items stored in the namespace.
​
namespaces[].created_at
string
ISO 8601 UTC timestamp when the namespace was created.
​
status
string
"failure" on server error (500).
​
message
string
Error description on failure.
Example output
{
  "namespaces": [
    {
      "namespace_name": "my-documents",
      "type": "text",
      "vector_dimension": null,
      "item_count": 42,
      "created_at": "2026-05-21T12:00:00.000Z"
    },
    {
      "namespace_name": "my-embeddings",
      "type": "vector",
      "vector_dimension": 768,
      "item_count": 10,
      "created_at": "2026-05-21T12:05:00.000Z"
    }
  ]
}

​
Exit codes

CodeMeaning
0Success
1API error — error JSON printed, message on stderr