Skip to main content

​
namespaces.list

Returns every namespace on this Moorcheh instance, including type, vector dimension, item count, and created time. 
client.namespaces.list() -> dict[str, Any]
API: GET /namespaces — see List namespaces

​
Parameters

None. Returns: dict[str, Any] — object with a namespaces array. Raises: MoorchehApiError on non-2xx responses.

​
Examples

List All Namespaces
from moorcheh import MoorchehClient

with MoorchehClient("http://localhost:8080") as client:
    result = client.namespaces.list()

    for ns in result["namespaces"]:
        print(
            ns["namespace_name"],
            ns["type"],
            ns["item_count"],
            ns["created_at"],
        )

​
Response Fields

FieldTypeDescription
namespacesarrayList of namespace objects (empty when none exist)
namespaces[].namespace_namestringUnique namespace name
namespaces[].typestring"text" or "vector"
namespaces[].vector_dimensionnumber | nullFixed vector length for vector namespaces
namespaces[].item_countnumberItems stored in this namespace
namespaces[].created_atstringISO 8601 UTC creation time

​
Error Handling

Error Handling Example
from moorcheh import MoorchehClient, MoorchehApiError

with MoorchehClient("http://localhost:8080") as client:
    try:
        result = client.namespaces.list()
    except MoorchehApiError as e:
        print(e.status_code, e.body)