# Create or update a Logstash pipeline

**PUT /_logstash/pipeline/{id}**

Create a pipeline that is used for Logstash Central Management.
If the specified pipeline exists, it is replaced.

## Required authorization

* Cluster privileges: `manage_logstash_pipelines`


[Centralized pipeline management](https://www.elastic.co/docs/reference/logstash/logstash-centralized-pipeline-management)

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


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


## Parameters

### Path parameters
- **id** (string)
  An identifier for the pipeline.
  Pipeline IDs must begin with a letter or underscore and contain only letters, underscores, dashes, hyphens and numbers.


### Body: application/json (object)

- **description** (string)
  A description of the pipeline.
  This description is not used by Elasticsearch or Logstash.
- **last_modified** (string | number)
  The date the pipeline was last updated.
  It must be in the `yyyy-MM-dd'T'HH:mm:ss.SSSZZ` strict_date_time format.
- **pipeline** (string)
  The configuration for the pipeline.
- **pipeline_metadata** (object)
  Optional metadata about the pipeline, which can have any contents.
  This metadata is not generated or used by Elasticsearch or Logstash.
- **pipeline_settings** (object)
  Settings for the pipeline.
  It supports only flat keys in dot notation.
- **username** (string)
  The user who last updated the pipeline.


## Responses
### 200



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