curl http://localhost:8080/namespaces
{
"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"
}
]
}
{
"namespaces": []
}
{
"status": "failure",
"message": "Internal Server Error fetching namespaces."
}
Namespace Management
List Namespaces
List all namespaces with type, vector dimension, item count, and created time.
GET
/
namespaces
curl http://localhost:8080/namespaces
{
"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"
}
]
}
{
"namespaces": []
}
{
"status": "failure",
"message": "Internal Server Error fetching namespaces."
}
Overview
Returns every namespace on this Moorcheh instance, including how many items each namespace contains and when it was created.On-prem does not use API keys. No request body or special headers are required.
curl http://localhost:8080/namespaces
Response fields
array
List of namespace objects. Empty array
[] when no namespaces exist yet.string
Unique name of the namespace.
string
"text" or "vector".number | null
Fixed vector length for vector namespaces.
null for text namespaces.number
Number of items stored in this namespace.
string
ISO 8601 UTC timestamp when the namespace was created, with millisecond precision (for example
"2026-05-21T12:00:00.000Z").string
"failure" on server error responses.string
Error description when the request fails.
{
"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"
}
]
}
{
"namespaces": []
}
{
"status": "failure",
"message": "Internal Server Error fetching namespaces."
}
Next Steps
Related
Was this page helpful?