anchor.diff:      }
     ]
   }
  ---------------------------------------------------
  -
  -Response:
  +----
  +
  +
  +[[simulate-pipeline-api-request]]
  +==== {api-request-title}
  +
  +POST /_ingest/pipeline/<pipeline>/_simulate
  +
  +GET /_ingest/pipeline/<pipeline>/_simulate
  +
  +POST /_ingest/pipeline/_simulate
  +
  +GET /_ingest/pipeline/_simulate
  +
  +
  +[[simulate-pipeline-api-desc]]
  +==== {api-description-title}
  +
  +The simulate pipeline API executes a specific pipeline
  +against a set of documents provided in the body of the request.
  +
  +You can either specify an existing pipeline
  +to execute against the provided documents
  +or supply a pipeline definition in the body of the request.
  +
  +
  +[[simulate-pipeline-api-path-params]]
  +==== {api-path-parms-title}
  +
  +`<pipeline>`::
  +(Optional, string)
  +Pipeline ID used to simulate an ingest.
  +
  +
  +[[simulate-pipeline-api-query-params]]
  +==== {api-query-parms-title}
  +
  +`verbose`::
  +(Optional, boolean)
  +If `true`,
  +the response includes output data
  +for each processor in the executed pipeline.
  +
  +
  +[[simulate-pipeline-api-request-body]]
  +==== {api-request-body-title}
  +
  +`description`::
  +(Optional, string)
  +Description of the ingest pipeline.
  +
  +`processors`::
  ++
  +--
  +(Optional, array of <<ingest-processors,processor objects>>)
  +Array of processors used to pre-process documents
  +during ingest.
  +
  +Processors are executed in the order provided.
  +
  +See <<ingest-processors>> for processor object definitions
  +and a list of built-in processors.
  +--
  +
  +`docs`::
  ++
  +--
  +(Required, array)
  +Array of documents
  +ingested by the pipeline.
  +
  +Document object parameters include:
  +
  +`_index`::
  +(Optional, string)
  +Name of the index containing the document.
  +
  +`_id`::
  +(Optional, string)
  +Unique identifier for the document.
  +This ID is only unique within the index.
  +
  +`_source`::
  +(Required, object)
  +JSON body for the document.
  +--
  +
  +
  +[[simulate-pipeline-api-example]]
  +==== {api-examples-title}
  +
  +
  +[[simulate-pipeline-api-path-parm-ex]]
  +===== Specify a pipeline as a path parameter
  +
  +[source,console]
  +----
  +POST /_ingest/pipeline/my-pipeline-id/_simulate
  +{
  +  "docs": [
  +    {
  +      "_index": "index",
  +      "_id": "id",
  +      "_source": {
  +        "foo": "bar"
  +      }
  +    },
  +    {
  +      "_index": "index",
  +      "_id": "id",
  +      "_source": {
  +        "foo": "rab"
  +      }
  +    }
  +  ]
  +}
  +----
  +
  +The API returns the following response:
   
   [source,console-result]
  ---------------------------------------------------
  +----
   {
      "docs": [
         {
  
positive.code:         }
        }
      ]
    },
    "docs": [
      {
        "_index": "index",
  
negative.code: 
  [[simulate-pipeline-api]]
  === Simulate pipeline API
  ++++
  <titleabbrev>Simulate pipeline</titleabbrev>
  ++++
  
  Executes an ingest pipeline against
  a set of provided documents.
  
  ////
  [source,console]
  ----
  PUT /_ingest/pipeline/my-pipeline-id
  {
    "description" : "example pipeline to simulate",
        "processors": [
        {
          "set" : {
            "field" : "field2",
  