anchor.diff:      }
     ]
   }
  ---------------------------------------------------
  +----
   
  -[float]
  +
  +[[put-pipeline-api-request]]
  +==== {api-request-title}
  +
  +`PUT /_ingest/pipeline/<pipeline>`
  +
  +
  +[[put-pipeline-api-path-params]]
  +==== {api-path-parms-title}
  +
  +`<pipeline>`::
  +(Required, string) ID of the ingest pipeline to create or update.
  +
  +
  +[[put-pipeline-api-query-params]]
  +==== {api-query-parms-title}
  +
  +include::{docdir}/rest-api/common-parms.asciidoc[tag=master-timeout]
  +
  +
  +[[put-pipeline-api-response-body]]
  +==== {api-response-body-title}
  +
  +`description`::
  +(Required, string)
  +Description of the ingest pipeline.
  +
  +`processors`::
  ++
  +--
  +(Required, array of <<ingest-processors,processor objects>>)
  +Array of processors used to pre-process documents
  +before indexing.
  +
  +Processors are executed in the order provided.
  +
  +See <<ingest-processors>> for processor object definitions
  +and a list of built-in processors.
  +--
  +
  +`version`::
  ++
  +--
  +(Optional, integer)
  +Optional version number used by external systems to manage ingest pipelines.
  +
  +Versions are not used or validated by {es};
  +they are intended for external management only.
  +--
  +
  +
  +[[put-pipeline-api-example]]
  +==== {api-examples-title}
  +
  +
   [[versioning-pipelines]]
  -==== Pipeline versioning
  +===== Pipeline versioning
   
  -Pipelines can optionally add a `version` number, which can be any integer value,
  -in order to simplify pipeline management by external systems. The `version`
  -field is completely optional and it is meant solely for external management of
  -pipelines.
  +When creating or updating an ingest pipeline,
  +you can specify an optional `version` parameter.
  +The version is useful for managing changes to pipeline
  +and viewing the current pipeline for an ingest node.
  +
  +The following request sets a version number of `123`
  +for `my-pipeline-id`.
   
   [source,console]
   --------------------------------------------------
  
positive.code: [[put-pipeline-api]]
  === Put Pipeline API
  
  The put pipeline API adds pipelines and updates existing pipelines in the cluster.
  
  [source,console]
  --------------------------------------------------
  PUT _ingest/pipeline/my-pipeline-id
  {
    "description" : "describe pipeline",
  
negative.code: }
  --------------------------------------------------
  
  ////
  [source,console]
  --------------------------------------------------
  DELETE /_ingest/pipeline/my-pipeline-id
  