Link Search Menu Expand Document Documentation Menu

You're viewing version 2.1 of the OpenSearch documentation. This version is no longer maintained. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.

Create and update a pipeline

The create ingest pipeline API operation creates or updates an ingest pipeline. Each pipeline requires an ingest definition defining how each processor transforms your documents.

Example

PUT _ingest/pipeline/12345
{
  "description" : "A description for your pipeline",
  "processors" : [
    {
      "set" : {
        "field": "field-name",
        "value": "value"
      }
    }
  ]
}

Path and HTTP methods

PUT _ingest/pipeline/{id}

Request body fields

Field Required Type Description
description Optional string Description of your ingest pipeline.
processors Required Array of processor objects A processor that transforms documents. Runs in the order specified. Appears in index once ran.
{
  "description" : "A description for your pipeline",
  "processors" : [
    {
      "set" : {
        "field": "field-name",
        "value": "value"
      }
    }
  ]
}

URL parameters

All URL parameters are optional.

Parameter Type Description
master_timeout time How long to wait for a connection to the master node.
timeout time How long to wait for the request to return.

Response

{
  "acknowledged" : true
}
350 characters left

Have a question? .

Want to contribute? or .