---
title: "Create standalone namespace (BYO vectors)"
method: POST
path: "/v1/namespaces/standalone"
tags: ["BYO Documents"]
---

# Create standalone namespace (BYO vectors)

`POST /v1/namespaces/standalone`

Create a standalone namespace for BYO (Bring Your Own) vectors. No collection or feature extractor binding is required. Users upsert pre-computed vectors directly via the direct upsert endpoint.

## Request body

- CreateStandaloneNamespaceRequestModel — Request body for POST /v1/namespaces/standalone.
  - `namespace_id` string, required — Unique namespace identifier
  - `vector_configs` VectorConfigSpecModel[] — Vector index configurations. If omitted, indexes are inferred on first upsert.
    - `name` string, required — Vector index name (e.g. 'text-embedding')
    - `dimension` integer, required — Vector dimension
    - `metric` string — Distance metric: cosine, euclidean, or dot_product
  - `storage` StandaloneStorageConfig — BYO object storage connection for WAL/snapshots/cold data.
    - `connection_id` string, nullable — Existing org storage connection ID
  - `config` object, nullable — Optional configuration (retention, version_history, tiering)
  - `auto_create_indexes` boolean, nullable — 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 `200`

Successful Response

- StandaloneNamespaceResponseModel — Response from standalone namespace creation.
  - `namespace_id` string, required
  - `mode` string
  - `status` string
  - `vector_configs` object[]
  - `tiering` string
  - `document_count` integer

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.net/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/versions/04b379bdbb7c/schema)