> For the complete MongoDB documentation index, see www.mongodb.com/docs/llms.txt

# Atlas Search Index Configuration File

You can use a search index configuration file to specify the settings required when you create an Atlas Search index or update an Atlas Search index using the Atlas CLI. The Atlas CLI accepts `.json` search index configuration files.

## Available Settings

When you create an Atlas Search index using a configuration file, you can specify any settings that are listed in [Create One Atlas Search Index](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclustersearchindex) under Request Body Schema.

When you update an Atlas Search index using a configuration file, you can specify any settings that are listed in [Update One Atlas Search Index](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclustersearchindex) under Request Body Schema.

## Create a Configuration File

### Create an Atlas Search Index

Follow these steps to create an Atlas Search index with a configuration file:

1. Copy the sample request for [Create One Atlas Search Index](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclustersearchindex).

   Navigate to the [Create One Atlas Search Index](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-creategroupclustersearchindex) section of the Atlas Admin API specification.

   Under Request samples on the right side, click Expand all.

   Click Copy to copy the sample request.

2. Create the configuration file.

   Paste the sample request into a text editor and change the values to reflect your desired configuration.

   Save the file with a `.json` extension.

3. Run the [atlas clusters search nodes create](https://www.mongodb.com/docs/atlas/cli/current/command/atlas-clusters-search-nodes-create.md#std-label-atlas-clusters-search-nodes-create) command with the `--file` option.

   Specify the path to the file you saved with the `--file` flag.

### Update an Atlas Search Index

Follow these steps to update an Atlas Search index with a configuration file:

1. Copy the sample request for [Update One Atlas Search Index](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclustersearchindex).

   Navigate to the [Update One Atlas Search Index](https://www.mongodb.com/docs/api/doc/atlas-admin-api-v2/operation/operation-updategroupclustersearchindex) section of the Atlas Admin API specification.

   Under Request samples on the right side, click Expand all.

   Click Copy to copy the sample request.

2. Create the configuration file.

   Paste the sample request into a text editor and change the values to reflect your desired configuration.

   Save the file with a `.json` extension.

3. Run the [atlas clusters search nodes update](https://www.mongodb.com/docs/atlas/cli/current/command/atlas-clusters-search-nodes-update.md#std-label-atlas-clusters-search-nodes-update) command with the `--file` option.

   Specify the path to the file you saved with the `--file` flag.
