---
title: "Create or update a Logstash pipeline"
method: PUT
path: "/api/logstash/pipeline/{id}"
tags: ["logstash"]
---

# Create or update a Logstash pipeline

`PUT /api/logstash/pipeline/{id}`

Create a centrally-managed Logstash pipeline or update a pipeline.
To use this API, you must have either the `logstash_admin` built-in role or a customized Logstash writer role.

## Path parameters

- `id` string, required

## Request body

- object
  - `description` string — A description of the pipeline.
  - `pipeline` string, required — A definition for the pipeline.
  - `settings` object — Supported settings, represented as object keys, include the following: - `pipeline.workers` - `pipeline.batch.size` - `pipeline.batch.delay` - `pipeline.ecs_compatibility` - `pipeline.ordered` - `queue.type` - `queue.max_bytes` - `queue.checkpoint.writes`

## Response `204`

Indicates a successful call

---

[API](https://skmtc.net/elastic/apis/kibana-apis.md) · [All operations](https://skmtc.net/elastic/apis/kibana-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elastic/kibana-apis/versions/deb2e8b751e7/schema)