anchor.diff:  [role="xpack"]
   [testenv="basic"]
   [[indices-reload-analyzers]]
  -== Reload Search Analyzers
  +== Reload search analyzers API
  +++++
  +<titleabbrev>Reload search analyzers</titleabbrev>
  +++++
   
  -experimental[]
  +experimental::[]
   
  -Reloads search analyzers and its resources.
  +Reloads an index's <<search-analyzer,search analyzers>> and their resources.
   
  -Synonym filters (both `synonym` and `synonym_graph`) can be declared as
  -updateable if they are only used in <<search-analyzer,search analyzers>> 
  -with the `updateable` flag:
  +[source,console]
  +--------------------------------------------------
  +POST /twitter/_reload_search_analyzers
  +--------------------------------------------------
  +// TEST[setup:twitter]
  +
  +[discrete]
  +[[indices-reload-analyzers-api-request]]
  +=== {api-request-title}
  +
  +`POST /<index>/_reload_search_analyzers`
  +
  +`GET /<index>/_reload_search_analyzers`
  +
  +
  +[discrete]
  +[[indices-reload-analyzers-api-desc]]
  +=== {api-description-title}
  +
  +You can use the reload search analyzers API
  +to pick up changes to synonym files
  +used in the <<analysis-synonym-graph-tokenfilter,`synonym_graph`>>
  +or <<analysis-synonym-tokenfilter,`synonym`>> token filter
  +of a <<search-analyzer,search analyzer>>.
  +To be eligible,
  +the token filter must have an `updateable` flag of `true`
  +and only be used in search analyzers.
  +
  +[NOTE]
  +====
  +This API does not perform a reload
  +for each shard of an index.
  +Instead,
  +it performs a reload for each node
  +containing index shards.
  +As a result,
  +the total shard count returned by the API
  +can differ from the number of index shards.
  +
  +Because reloading affects every node with an index shard,
  +its important to update the synonym file
  +on every data node in the cluster,
  +including nodes that don't contain a shard replica,
  +before using this API.
  +This ensures the synonym file is updated
  +everywhere in the cluster
  +in case shards are relocated
  +in the future.
  +====
  +
  +
  +[discrete]
  +[[indices-reload-analyzers-api-path-params]]
  +=== {api-path-parms-title}
  +
  +`<index>`::
  +(Required, string)
  +Comma-separated list or wildcard expression of index names
  +used to limit the request.
  +
  +
  +[discrete]
  +[[indices-reload-analyzers-api-query-params]]
  +=== {api-query-parms-title}
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=allow-no-indices]
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=expand-wildcards]
  ++
  +Defaults to `open`.
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=index-ignore-unavailable]
  +
  +
  +[discrete]
  +[[indices-reload-analyzers-api-example]]
  +=== {api-examples-title}
  +
  +Use the <<indices-create-index, create index API>>
  +to create an index with a search analyzer
  +that contains an updateable synonym filter.
  +
  +NOTE: Using the following analyzer as an index analyzer results in an error.
   
   [source,console]
   --------------------------------------------------
  
positive.code: --------------------------------------------------
  // TEST[continued]
  
  The reload request returns information about the nodes it was executed on and the
  analyzers that were reloaded:
  
  [source,console-result]
  --------------------------------------------------
  
negative.code:                 },
                  "filter" : {
                      "synonym" : {
                          "type" : "synonym_graph",
                          "synonyms_path" : "analysis/synonym.txt", <1>
                          "updateable" : true <2>
                      }
                  }
              }
  