[[logstash-configuration-management-api-create]]
=== Create Logstash pipeline API
++++
Create Logstash pipeline
++++
experimental[] Create a centrally-managed Logstash pipeline, or update an existing pipeline.
[[logstash-configuration-management-api-create-request]]
==== Request
`PUT :/api/logstash/pipeline/`
[[logstash-configuration-management-api-create-params]]
==== Path parameters
`id`::
(Required, string) The pipeline ID. Only alphanumeric characters, hyphens, and underscores are supported.
[[logstash-configuration-management-api-create-request-body]]
==== Request body
`id`::
(Required, string) The pipeline ID.
`description`::
(Optional, string) The pipeline description.
`pipeline`::
(Required, string) The pipeline definition.
`settings`::
(Optional, object) The pipeline settings. Supported settings, represented as object keys, are `pipeline.workers`, `pipeline.batch.size`, `pipeline.batch.delay`, `queue.type`, `queue.max_bytes`, and `queue.checkpoint.writes`.
[[logstash-configuration-management-api-create-codes]]
==== Response code
`204 No Content`::
Indicates a successful call.
[float]
[[logstash-configuration-management-api-create-example]]
==== Example
[source,sh]
--------------------------------------------------
$ curl -X PUT api/logstash/pipeline/hello-world
{
"pipeline": "input { stdin {} } output { stdout {} }",
"settings": {
"queue.type": "persisted"
}
}
--------------------------------------------------
// KIBANA