Skip to main content
POST
Dry-run validate a standalone → managed promotion

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, malformed, unknown, revoked, inactive or expired key returns 401; a key without the permission, scope or plan an operation needs returns 403.

Path Parameters

namespace_id
string
required

Namespace to validate promotion for

Body

application/json

Keys this body does not declare are ignored, and the response's warnings name them, until 2026-11-02; from 2026-11-02 they are refused with 422 extra_forbidden naming the accepted keys.

vector_mappings
VectorMappingModel · object[]

Map existing vector indexes to inference services

add_vectors
NewVectorConfigSpecModel · object[]

New vector indexes to add during promotion

Response

Successful Response

namespace_id
string
required
current_mode
string
required
valid
boolean
required
required_user_action
string
required
vector_configs
Vector Configs · object[]
suggestions
Suggestions · object[]
errors
Errors · object[]