Copy or move an index

Copies or moves (renames) an index within the same Algolia application.

• Existing destination indices are overwritten, except for their analytics data.
• If the destination index doesn’t exist yet, it’ll be created.

Copy

• Copying a source index that doesn’t exist creates a new index with 0 records and default settings.
• The API keys of the source index are merged with the existing keys in the destination index.
• You can’t copy the enableReRanking, mode, and replicas settings.
• You can’t copy to a destination index that already has replicas.
• Be aware of the size limits.
• Related guide: Copy indices

Move

• Moving a source index that doesn’t exist is ignored without returning an error.
• When moving an index, the analytics data keeps its original name, and a new set of analytics data is started for the new name. To access the original analytics in the dashboard, create an index with the original name.
• If the destination index has replicas, moving will overwrite the existing index and copy the data to the replica indices.
• Related guide: Move indices.

Usage

1
2
3
4
5
6
7
8
9
10
11
12
13
import com.algolia.client.api.SearchClient
import com.algolia.client.extensions.*

val client = SearchClient(appId = "ALGOLIA_APPLICATION_ID", apiKey = "ALGOLIA_API_KEY")

var response = client.operationIndex(
  indexName = "<SOURCE_INDEX_NAME>",
  operationIndexParams = OperationIndexParams(
    operation = OperationType.entries.first { it.value == "move" },
    destination = "<DESTINATION_INDEX_NAME>",
    scope = listOf(ScopeType.entries.first { it.value == "rules" }, ScopeType.entries.first { it.value == "settings" }),
  ),
)