Skip to main content
POST
Create standalone namespace (BYO vectors)

Authorizations

Authorization
string
header
required

Mixpeek API key, sent as Authorization: Bearer mxp_sk_.... Create one in Studio under Settings → API Keys, or with an admin key via POST /v1/organizations/users/{user_email}/api-keys. A missing header returns 403; an invalid or revoked key returns 401.

Body

application/json

Request body for POST /v1/namespaces/standalone.

namespace_id
string
required

Unique namespace identifier

Example:

"ns_my_vectors"

vector_configs
VectorConfigSpecModel · object[]

Vector index configurations. If omitted, indexes are inferred on first upsert.

storage
StandaloneStorageConfig · object | null

Optional BYO object storage connection

config
Config · object | null

Optional configuration (retention, version_history, tiering)

auto_create_indexes
boolean | null

Adaptive payload indexing. Standalone namespaces default to on (indexes are inferred/created from filter usage). Set explicitly to false to opt out and manage payload indexes yourself.

Response

Successful Response

Response from standalone namespace creation.

namespace_id
string
required
mode
string
default:standalone
status
string
default:active
vector_configs
Vector Configs · object[]
tiering
string
default:auto
document_count
integer
default:0