List Namespaces

curl -X GET "https://api.moorcheh.ai/v1/namespaces" \
  -H "x-api-key: your-api-key-here"

{
  "namespaces": [
    {
      "namespace_name": "my_documents",
      "type": "text",
      "vector_dimension": null,
      "item_count": 1247,
      "created_at": "2024-01-15T10:30:00.000Z"
    },
    {
      "namespace_name": "product_embeddings",
      "type": "vector",
      "vector_dimension": 1536,
      "item_count": 5683,
      "created_at": "2024-01-20T14:22:15.000Z"
    },
    {
      "namespace_name": "customer_support",
      "type": "text",
      "vector_dimension": null,
      "item_count": 892,
      "created_at": "2024-02-01T09:15:30.000Z"
    }
  ]
}

{
  "message": "Unauthorized: Missing API key"
}

{
  "message": "Unauthorized: API key verification failed - Invalid API key ID"
}

{
  "message": "Unauthorized: API key is disabled"
}

{
  "status": "failure",
  "message": "Forbidden"
}

{
  "status": "failure",
  "message": "API request limit reached for Professional plan (1000000 requests). Current usage: 1000000. Please upgrade your subscription for higher limits.",
  "current_usage": 1000000,
  "limit": 1000000
}

{
  "status": "failure",
  "message": "Your Community subscription expired on 8/15/2025. Please renew your subscription to continue using the service."
}

{
  "status": "failure",
  "message": "Internal Server Error fetching namespaces."
}

GET

namespaces

curl -X GET "https://api.moorcheh.ai/v1/namespaces" \
  -H "x-api-key: your-api-key-here"

{
  "namespaces": [
    {
      "namespace_name": "my_documents",
      "type": "text",
      "vector_dimension": null,
      "item_count": 1247,
      "created_at": "2024-01-15T10:30:00.000Z"
    },
    {
      "namespace_name": "product_embeddings",
      "type": "vector",
      "vector_dimension": 1536,
      "item_count": 5683,
      "created_at": "2024-01-20T14:22:15.000Z"
    },
    {
      "namespace_name": "customer_support",
      "type": "text",
      "vector_dimension": null,
      "item_count": 892,
      "created_at": "2024-02-01T09:15:30.000Z"
    }
  ]
}

{
  "message": "Unauthorized: Missing API key"
}

{
  "message": "Unauthorized: API key verification failed - Invalid API key ID"
}

{
  "message": "Unauthorized: API key is disabled"
}

{
  "status": "failure",
  "message": "Forbidden"
}

{
  "status": "failure",
  "message": "API request limit reached for Professional plan (1000000 requests). Current usage: 1000000. Please upgrade your subscription for higher limits.",
  "current_usage": 1000000,
  "limit": 1000000
}

{
  "status": "failure",
  "message": "Your Community subscription expired on 8/15/2025. Please renew your subscription to continue using the service."
}

{
  "status": "failure",
  "message": "Internal Server Error fetching namespaces."
}

Overview

Retrieve a comprehensive list of all namespaces in your account, including their metadata, document counts, and usage statistics. This endpoint provides essential information for namespace management and monitoring.

The response includes both text and vector namespaces, with type-specific metadata for each.

Each namespace object uses snake_case keys, including item_count and created_at (not camelCase).

Authentication

string

required

Your API key for authentication

string

required

Must be application/json

Query Parameters

This endpoint does not accept query parameters. All namespaces for the authenticated user are returned.

curl -X GET "https://api.moorcheh.ai/v1/namespaces" \
  -H "x-api-key: your-api-key-here"

{
  "namespaces": [
    {
      "namespace_name": "my_documents",
      "type": "text",
      "vector_dimension": null,
      "item_count": 1247,
      "created_at": "2024-01-15T10:30:00.000Z"
    },
    {
      "namespace_name": "product_embeddings",
      "type": "vector",
      "vector_dimension": 1536,
      "item_count": 5683,
      "created_at": "2024-01-20T14:22:15.000Z"
    },
    {
      "namespace_name": "customer_support",
      "type": "text",
      "vector_dimension": null,
      "item_count": 892,
      "created_at": "2024-02-01T09:15:30.000Z"
    }
  ]
}

{
  "message": "Unauthorized: Missing API key"
}

{
  "message": "Unauthorized: API key verification failed - Invalid API key ID"
}

{
  "message": "Unauthorized: API key is disabled"
}

{
  "status": "failure",
  "message": "Forbidden"
}

{
  "status": "failure",
  "message": "API request limit reached for Professional plan (1000000 requests). Current usage: 1000000. Please upgrade your subscription for higher limits.",
  "current_usage": 1000000,
  "limit": 1000000
}

{
  "status": "failure",
  "message": "Your Community subscription expired on 8/15/2025. Please renew your subscription to continue using the service."
}

{
  "status": "failure",
  "message": "Internal Server Error fetching namespaces."
}

Response Fields

Namespace Object

string

Unique name of the namespace

string

Namespace type: “text” or “vector”

number|null

Vector dimension (null for text namespaces)

number

Total number of items in the namespace

string

ISO 8601 timestamp of creation

Use Cases

Dashboard Display: Show namespace overview with usage statistics
Data Management: Monitor storage usage and document counts
Namespace Selection: Populate dropdowns for namespace selection in applications
Usage Analytics: Track namespace growth and activity over time
Resource Planning: Understand storage and document distribution across namespaces

Create Namespace - Create a new namespace
Delete Namespace - Remove a namespace
Upload Data - Add data to namespaces

Create Namespace Delete Namespace

Getting Started

Namespace Management

Search & Discovery

AI Generation

Data Operations

File storage

Overview

Authentication

Query Parameters

Response Fields

Namespace Object

Use Cases

​Overview

​Authentication

​Query Parameters

​Response Fields

​Namespace Object

​Use Cases

​Related Endpoints

Overview

Authentication

Query Parameters

Response Fields

Namespace Object

Use Cases

Related Endpoints