---
type: api
title: Data stream
url: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/group/endpoint-data-stream
resource: https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/group/endpoint-data-stream
products:
  - Elasticsearch
---

# Data stream

`data stream`

[Learn more about data streams.](https://www.elastic.co/guide/en/elasticsearch/reference/8.19/data-streams.html)

- [Get data streams
](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-indices-get-data-stream): `GET` `/_data_stream/{name}`, `GET` `/_data_stream`
- [Create a data stream](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-indices-create-data-stream): `PUT` `/_data_stream/{name}`
- [Delete data streams](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-indices-delete-data-stream): `DELETE` `/_data_stream/{name}`
- [Get data stream stats
](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-indices-data-streams-stats): `GET` `/_data_stream/{name}/_stats`, `GET` `/_data_stream/_stats`
- [Get data stream lifecycles](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-indices-get-data-lifecycle): `GET` `/_data_stream/{name}/_lifecycle`
- [Update data stream lifecycles](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-indices-put-data-lifecycle): `PUT` `/_data_stream/{name}/_lifecycle`
- [Get data stream options](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-indices-get-data-stream-options): `GET` `/_data_stream/{name}/_options`
- [Update data stream options](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-indices-put-data-stream-options): `PUT` `/_data_stream/{name}/_options`
- [Delete data stream options](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-indices-delete-data-stream-options): `DELETE` `/_data_stream/{name}/_options`
- [Downsample an index](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-indices-downsample): `POST` `/{index}/_downsample/{target_index}`
- [Get the status for a data stream lifecycle](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-indices-explain-data-lifecycle): `GET` `/{index}/_lifecycle/explain`
- [Get data stream lifecycle stats](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-indices-get-data-lifecycle-stats): `GET` `/_lifecycle/stats`
- [Get data stream settings](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-indices-get-data-stream-settings): `GET` `/_data_stream/{name}/_settings`
- [Update data stream settings](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-indices-put-data-stream-settings): `PUT` `/_data_stream/{name}/_settings`
- [Convert an index alias to a data stream](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-indices-migrate-to-data-stream): `POST` `/_data_stream/_migrate/{name}`
- [Update data streams](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-indices-modify-data-stream): `POST` `/_data_stream/_modify`
- [Promote a data stream](https://www.elastic.co/elastic/docs-builder/docs/4371/api/doc/elasticsearch/v8/operation/operation-indices-promote-data-stream): `POST` `/_data_stream/_promote/{name}`