Skip to main content
POST

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/json

Body

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)

Next Steps

After creating a namespace, you can:

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