elastic / elastic/docs-content

[Feedback]: "Reindex documents" API documentation does not describe meaning of dest.routing parameter

Open
#1,414 11 comments 0 reactions 1 assignee Claimed by @leemthompo View on GitHub
API docs api-feedback blocked Team:Developer
Dominant language
No language data
Stars
47
Forks
261
Avg merge
3d 12h
Merged PRs (30d)
116

Description

### Was the documentation helpful?

No

### What documentation page is affected

https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-reindex#operation-reindex-body-application-json-dest-routing

### Description

The [Elasticsearch 8 API docs](https://www.elastic.co/guide/en/elasticsearch/reference/8.18/docs-reindex.html#docs-reindex-routing) included a nice description of how to use the `dest.routing` parameter to control routing:

> Reindex routing
>
> By default if `_reindex` sees a document with routing then the routing is preserved unless it’s changed by the script. You can set `routing` on the `dest` request to change this:
>
> `keep`
> Sets the routing on the bulk request sent for each match to the routing on the match. This is the default value.
> `discard`
> Sets the routing on the bulk request sent for each match to null.
> `=`
> Sets the routing on the bulk request sent for each match to all text after the =.

But the [new documentation page](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-reindex#operation-reindex-body-application-json-dest-routing) doesn't seem to describe at all what the parameter means or how to use it.

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.