add new experimental feature

Author: guimachiavelli

.code-samples.meilisearch.yaml

@@ -1596,3 +1596,14 @@ search_parameter_reference_media_1: |-
       }
     }
   }'
+get_vector_store_settings_1: |-
+  curl \
+    -X GET 'MEILISEARCH_URL/indexes/INDEX_UID/settings/vector-store'
+update_vector_store_settings_1: |-
+  curl \
+    -X PUT 'MEILISEARCH_URL/indexes/INDEX_UID/settings/vector-store' \
+    -H 'Content-Type: application/json' \
+    --data-binary '"experimental"'
+reset_vector_store_settings_1: |-
+  curl \
+    -X DELETE 'MEILISEARCH_URL/indexes/INDEX_UID/settings/vector-store'

learn/resources/experimental_features_overview.mdx

@@ -61,4 +61,4 @@ Activating or deactivating experimental features this way does not require you t
 | [Maximum batch payload size](/learn/self_hosted/configure_meilisearch_at_launch#maximum-batch-payload-size) | Limit batch payload size                                       | CLI flag or environment variable            |
 | [Multimodal search](/reference/api/settings)                                                    | Enable multimodal search                                                   | API route                                   |
 | [Disable new indexer](/learn/self_hosted/configure_meilisearch_at_launch)                       | Use previous settings indexer                                              | CLI flag or environment variable            |
-
+| [Experimental vector store](/reference/api/settings)                       | Enables index setting to use experimental vector store                                              | API route            |

reference/api/experimental_features.mdx

@@ -27,7 +27,8 @@ The experimental API route is not compatible with all experimental features. Con
   "editDocumentsByFunction": false,
   "network": false,
   "chatCompletions": false,
-  "multimodal": false
+  "multimodal": false,
+  "vectorStoreSetting": false
 }
 ```
 
@@ -40,6 +41,7 @@ The experimental API route is not compatible with all experimental features. Con
 | **`network`**                 | Boolean | `true` if feature is active, `false` otherwise |
 | **`chatCompletions`**         | Boolean | `true` if feature is active, `false` otherwise |
 | **`multimodal`**              | Boolean | `true` if feature is active, `false` otherwise |
+| **`vectorStoreSetting`**      | Boolean | `true` if feature is active, `false` otherwise |
 
 ## Get all experimental features
 
@@ -61,7 +63,8 @@ Get a list of all experimental features that can be activated via the `/experime
   "editDocumentsByFunction": false,
   "network": false,
   "chatCompletions": false,
-  "multimodal": false
+  "multimodal": false,
+  "vectorStoreSetting": false
 }
 ```
 
@@ -90,7 +93,7 @@ Setting a field to `null` leaves its value unchanged.
   "containsFilter": false,
   "editDocumentsByFunction": false,
   "network": false,
-  "chatCompletions": false,
-  "multimodal": false
+  "multimodal": false,
+  "vectorStoreSetting": false
 }
 ```

reference/api/settings.mdx

@@ -69,6 +69,9 @@ import CodeSamplesUpdateSortableAttributes1 from '/snippets/samples/code_samples
 import CodeSamplesUpdateStopWords1 from '/snippets/samples/code_samples_update_stop_words_1.mdx';
 import CodeSamplesUpdateSynonyms1 from '/snippets/samples/code_samples_update_synonyms_1.mdx';
 import CodeSamplesUpdateTypoTolerance1 from '/snippets/samples/code_samples_update_typo_tolerance_1.mdx';
+import CodeSamplesGetVectorStore1 from '/snippets/samples/code_samples_get_vector_store_1.mdx';
+import CodeSamplesUpdateVectorStore1 from '/snippets/samples/code_samples_update_vector_store_1.mdx';
+import CodeSamplesResetVectorStore1 from '/snippets/samples/code_samples_reset_vector_store_1.mdx';
 
 Use the `/settings` route to customize search settings for a given index. You can either modify all index settings at once using the [update settings endpoint](#update-settings), or use a child route to configure a single setting.
 
@@ -3053,7 +3056,6 @@ curl \
     "chatCompletions": true
   }'
 ```
-
 </Note>
 
 The chat settings allow you to configure how your index integrates with Meilisearch's conversational search feature.
@@ -3185,3 +3187,115 @@ curl \
 ```
 
 You can use the returned `taskUid` to get more details on [the status of the task](/reference/api/tasks#get-one-task).
+
+## Vector store <NoticeTag type="experimental" label="experimental" />
+
+<Note>
+This is an experimental feature. Use the Meilisearch Cloud UI or the experimental features endpoint to activate it:
+
+```sh
+curl \
+  -X PATCH 'http://localhost:7700/experimental-features/' \
+  -H 'Authorization: Bearer MEILISEARCH_API_KEY' \
+  -H 'Content-Type: application/json' \
+  --data-binary '{
+    "vectorStoreSetting": true
+  }'
+```
+</Note>
+
+Use `vectorStore` to switch between the `stable` and `experimental` vector store.
+
+The experimental vector store may improve performance in large Meilisearch databases that make heavy use of AI-powered search features.
+
+### Get vector store settings
+
+<RouteHighlighter method="GET" path="/indexes/{index_uid}/settings/vector-store" />
+
+Get the vector store of an index.
+
+#### Path parameters
+
+| Name              | Type   | Description                                                            |
+| :---------------- | :----- | :--------------------------------------------------------------------- |
+| **`index_uid`** * | String | [`uid`](/learn/getting_started/indexes#index-uid) of the requested index |
+
+#### Example
+
+<CodeSamplesGetVectorStoreSettings1 />
+
+##### Response: `200 OK`
+
+```json
+"stable"
+```
+
+### Update vector store settings
+
+<RouteHighlighter method="PUT" path="/indexes/{index_uid}/settings/vector-store" />
+
+Update the vector store of an index.
+
+When switching between vector stores, Meilisearch must convert all vector data for use with the new backend. This operation may take a significant amount of time in existing indexes. If a conversion is taking too long, create a new empty index, set its store to `experimental`, and add your documents.
+
+#### Path parameters
+
+| Name              | Type   | Description                                                            |
+| :---------------- | :----- | :--------------------------------------------------------------------- |
+| **`index_uid`** * | String | [`uid`](/learn/getting_started/indexes#index-uid) of the requested index |
+
+#### Body
+
+```
+"stable" | "experimental"
+```
+
+#### Example
+
+<CodeSamplesUpdateVectorStoreSettings1 />
+
+##### Response: `202 Accepted`
+
+```json
+{
+  "taskUid": 1,
+  "indexUid": "INDEX_UID",
+  "status": "enqueued",
+  "type": "settingsUpdate",
+  "enqueuedAt": "2024-07-19T22:33:18.523881Z"
+}
+```
+
+Use the returned `taskUid` to get more details on [the status of the task](/reference/api/tasks#get-one-task).
+
+### Reset vector store settings
+
+<RouteHighlighter method="DELETE" path="/indexes/{index_uid}/settings/vector-store" />
+
+Reset an index's vector store to its default settings.
+
+If you had set `vectorStore` to anything other than the default value, resetting triggers a convertion operation. This operation may take a significant amount of time depending on the size of the index.
+
+#### Path parameters
+
+| Name              | Type   | Description                                                            |
+| :---------------- | :----- | :--------------------------------------------------------------------- |
+| **`index_uid`** * | String | [`uid`](/learn/getting_started/indexes#index-uid) of the requested index |
+
+#### Example
+
+<CodeSamplesResetFacetSearchSettings1 />
+
+##### Response: `202 Accepted`
+
+```json
+{
+  "taskUid": 1,
+  "indexUid": "INDEX_UID",
+  "status": "enqueued",
+  "type": "settingsUpdate",
+  "enqueuedAt": "2024-07-19T22:35:33.723983Z"
+}
+```
+
+Use the returned `taskUid` to get more details on [the status of the task](/reference/api/tasks#get-one-task).