---
title: "Promote standalone namespace to managed mode"
method: POST
path: "/v1/namespaces/{namespace_id}/promote"
tags: ["BYO Documents"]
---

# Promote standalone namespace to managed mode

`POST /v1/namespaces/{namespace_id}/promote`

Promote a standalone (BYO vectors) namespace to managed mode. Existing vectors and documents are preserved. Optionally maps existing vector indexes to inference services and adds new indexes.

## Path parameters

- `namespace_id` string, required — Namespace to promote

## Request body

- PromoteNamespaceRequestModel
  - `vector_mappings` VectorMappingModel[] — Map existing vector indexes to inference services
    - `existing_index` string, required — Name of existing vector index
    - `inference_service` string, required — Inference service to bind (e.g. 'openai_text_3_large')
  - `add_vectors` NewVectorConfigSpecModel[] — New vector indexes to add during promotion
    - `name` string, required — New vector index name
    - `dimension` integer, required — Vector dimension
    - `metric` string — Distance metric
    - `inference_service` string, nullable — Optional inference service binding

## Response `200`

Successful Response

- PromoteNamespaceResponseModel
  - `namespace_id` string, required
  - `previous_mode` string, required
  - `mode` string, required
  - `status` string, required
  - `vector_configs` object[]
  - `vector_inference_map` object

## 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/220a3b263fda/schema)