---
title: "Dry-run validate a standalone → managed promotion"
method: POST
path: "/v1/namespaces/{namespace_id}/promote/validate"
tags: ["BYO Documents"]
---

# Dry-run validate a standalone → managed promotion

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

Validate a proposed promotion without mutating the namespace. Returns per-index mapping suggestions (dimension-matched candidates, flagged low-confidence) and validates any supplied vector_mappings / add_vectors for unknown indexes, unknown inference services, and dimension mismatches. Returns HTTP 422 when supplied mappings are invalid so callers can fix them before the real promote call.

## Path parameters

- `namespace_id` string, required — Namespace to validate promotion for

## 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

- PromoteValidateResponseModel
  - `namespace_id` string, required
  - `current_mode` string, required
  - `valid` boolean, required
  - `vector_configs` object[]
  - `suggestions` object[]
  - `errors` object[]
  - `required_user_action` string, required

## 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)