curl -X POST "https://api.moorcheh.ai/v1/namespaces" \
-H "Content-Type: application/json" \
-H "x-api-key: your-api-key-here" \
-d '{
"namespace_name": "my-documents",
"type": "text"
}'
curl -X POST "https://api.moorcheh.ai/v1/namespaces" \
-H "Content-Type: application/json" \
-H "x-api-key: your-api-key-here" \
-d '{
"namespace_name": "my-embeddings",
"type": "vector",
"vector_dimension": 1536
}'
{
"status": "success",
"message": "Namespace 'my-documents' created successfully. ✅",
"namespace_name": "my-documents"
}
{
"status": "failure",
"message": "Bad Request: namespace_name must contain only alphanumeric characters, hyphens, and underscores."
}
{
"status": "failure",
"message": "Unauthorized: Invalid API key"
}
{
"status": "failure",
"message": "Namespace limit reached for Free tier (5 namespaces). Please upgrade your subscription for higher limits."
}
{
"status": "failure",
"message": "Forbidden"
}
{
"status": "failure",
"message": "Namespace 'my-namespace' already exists."
}
{
"status": "failure",
"message": "Internal Server Error creating namespace."
}
Namespace Management
Create Namespace
Create a new namespace to organize and store your data. Namespaces can be either text-based for document storage or vector-based for embedding storage.
POST
/
v1
/
namespaces
curl -X POST "https://api.moorcheh.ai/v1/namespaces" \
-H "Content-Type: application/json" \
-H "x-api-key: your-api-key-here" \
-d '{
"namespace_name": "my-documents",
"type": "text"
}'
curl -X POST "https://api.moorcheh.ai/v1/namespaces" \
-H "Content-Type: application/json" \
-H "x-api-key: your-api-key-here" \
-d '{
"namespace_name": "my-embeddings",
"type": "vector",
"vector_dimension": 1536
}'
{
"status": "success",
"message": "Namespace 'my-documents' created successfully. ✅",
"namespace_name": "my-documents"
}
{
"status": "failure",
"message": "Bad Request: namespace_name must contain only alphanumeric characters, hyphens, and underscores."
}
{
"status": "failure",
"message": "Unauthorized: Invalid API key"
}
{
"status": "failure",
"message": "Namespace limit reached for Free tier (5 namespaces). Please upgrade your subscription for higher limits."
}
{
"status": "failure",
"message": "Forbidden"
}
{
"status": "failure",
"message": "Namespace 'my-namespace' already exists."
}
{
"status": "failure",
"message": "Internal Server Error creating namespace."
}
Overview
Create a new namespace to organize and store your data. Namespaces provide isolated environments for your documents or vectors, ensuring data separation and enabling organized data management.Namespace names must be unique within your account and can only contain alphanumeric characters, hyphens, and underscores.
Authentication
string
required
Your API key for authentication
string
required
Must be
application/jsonBody
string
required
Unique name for the namespace (alphanumeric, hyphens, underscores only)
string
required
Namespace type: “text” or “vector”
number
Required for vector namespaces. Dimension of vectors to be stored (e.g., 1536 for OpenAI embeddings)
curl -X POST "https://api.moorcheh.ai/v1/namespaces" \
-H "Content-Type: application/json" \
-H "x-api-key: your-api-key-here" \
-d '{
"namespace_name": "my-documents",
"type": "text"
}'
curl -X POST "https://api.moorcheh.ai/v1/namespaces" \
-H "Content-Type: application/json" \
-H "x-api-key: your-api-key-here" \
-d '{
"namespace_name": "my-embeddings",
"type": "vector",
"vector_dimension": 1536
}'
{
"status": "success",
"message": "Namespace 'my-documents' created successfully. ✅",
"namespace_name": "my-documents"
}
{
"status": "failure",
"message": "Bad Request: namespace_name must contain only alphanumeric characters, hyphens, and underscores."
}
{
"status": "failure",
"message": "Unauthorized: Invalid API key"
}
{
"status": "failure",
"message": "Namespace limit reached for Free tier (5 namespaces). Please upgrade your subscription for higher limits."
}
{
"status": "failure",
"message": "Forbidden"
}
{
"status": "failure",
"message": "Namespace 'my-namespace' already exists."
}
{
"status": "failure",
"message": "Internal Server Error creating namespace."
}
Next Steps
After creating a namespace, you can:- Upload text documents for text namespaces
- Upload vector data for vector namespaces
- List all namespaces to view your created namespaces
- Search your data once data is uploaded
Important Notes
- Namespace type cannot be changed after creation
- Vector dimension must be specified for vector namespaces and cannot be modified
- Namespace creation counts toward your tier limits
- Namespace names must be unique within your account
Was this page helpful?