# Create or update a pipeline

**PUT /_ingest/pipeline/{id}**

Changes made using this API take effect immediately.

[External documentation](https://www.elastic.co/docs/manage-data/ingest/transform-enrich/ingest-pipelines)

## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Api key auth
- Basic auth
- Bearer auth


## Parameters

### Path parameters
- **id** (string)
  ID of the ingest pipeline to create or update.

### Query parameters
- **master_timeout** (string)
  Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.
- **timeout** (string)
  Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.
- **if_version** (number)
  Required version for optimistic concurrency control for pipeline updates

### Body: application/json (object)

- **_meta** (object)
  Optional metadata about the ingest pipeline. May have any contents. This map is not automatically generated by Elasticsearch.
- **description** (string)
  Description of the ingest pipeline.
- **on_failure** (array[object])
  Processors to run immediately after a processor failure. Each processor supports a processor-level `on_failure` value. If a processor without an `on_failure` value fails, Elasticsearch uses this pipeline-level parameter as a fallback. The processors in this parameter run sequentially in the order specified. Elasticsearch will not attempt to run the pipeline's remaining processors.
- **processors** (array[object])
  Processors used to perform transformations on documents before indexing. Processors run sequentially in the order specified.
- **version** (number)
  Version number used by external systems to track ingest pipelines. This parameter is intended for external systems only. Elasticsearch does not use or validate pipeline version numbers.
- **deprecated** (boolean)
  Marks this ingest pipeline as deprecated.
  When a deprecated ingest pipeline is referenced as the default or final pipeline when creating or updating a non-deprecated index template, Elasticsearch will emit a deprecation warning.
- **field_access_pattern** (string)
  Controls how processors in this pipeline should read and write data on a document's source.


## Responses
### 200


#### Body: application/json (object)
- **acknowledged** (boolean)
  For a successful response, this value is always true. On failure, an exception is returned instead.


[Powered by Bump.sh](https://bump.sh)