---
title: "Create a managed index"
method: POST
path: "/v1/rag/managed_indexes"
tags: ["beta.rag.managed_indexes"]
---

# Create a managed index

`POST /v1/rag/managed_indexes`

Reserves a managed search index and starts asynchronous backing-table provisioning. Poll the returned Location until status is ready or failed.

## Request body

- CreateManagedIndexRequest
  - `name` string, required
  - `schema` ManagedIndexFields
    - `document_fields` object
    - `chunk_fields` object
  - `config` ManagedIndexConfig, required
    - `embedding` union, required
      - MistralEmbeddingModel
        - `type` 'mistral'
        - `name` string, required
        - `dtype` 'float16' | 'float32'
        - `dimensions` integer, required
        - `distance_metric` 'cosine' | 'inner_product' | 'l2'
      - CustomEmbeddingModel
        - `type` 'custom'
        - `name` string, required
        - `dtype` 'float16' | 'float32'
        - `dimensions` integer, required
        - `distance_metric` 'cosine' | 'inner_product' | 'l2'

## Response `202`

Index reserved and queued for provisioning

- ManagedIndexResponse — Wire representation of a managed index (decoupled from the domain model).
  - `id` string, uuid, required
  - `name` string, required
  - `status` 'provisioning' | 'ready' | 'failed' | 'deleting', required — Lifecycle of an index. Derived, not stored -- see ``managed_index_from_row``.
  - `status_message` string, nullable
  - `schema` ManagedIndexFields, required
    - `document_fields` object
    - `chunk_fields` object
  - `config` ManagedIndexConfig, required
    - `embedding` union, required
      - MistralEmbeddingModel
        - `type` 'mistral'
        - `name` string, required
        - `dtype` 'float16' | 'float32'
        - `dimensions` integer, required
        - `distance_metric` 'cosine' | 'inner_product' | 'l2'
      - CustomEmbeddingModel
        - `type` 'custom'
        - `name` string, required
        - `dtype` 'float16' | 'float32'
        - `dimensions` integer, required
        - `distance_metric` 'cosine' | 'inner_product' | 'l2'
  - `created_at` string, date-time, nullable
  - `modified_at` string, date-time, nullable

## Other responses

- `409` — An index with the same name already exists
- `422` — Validation Error

## Changes

- **2026-09-23** `fa73befe1c61` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mistral/apis/mistral-ai-api/changes/v1/rag/managed_indexes/post.md)

---

[API](https://skmtc.dev/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.dev/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mistral/apis/mistral-ai-api/revisions/fa73befe1c61?raw)