---
title: "Create a data view"
method: POST
path: "/api/data_views/data_view"
tags: ["data views"]
---

# Create a data view

`POST /api/data_views/data_view`

**Spaces method and path for this operation:**

<div><span class="operation-verb post">post</span>&nbsp;<span class="operation-path">/s/{space_id}/api/data_views/data_view</span></div>

Refer to [Spaces](https://www.elastic.co/docs/deploy-manage/manage-spaces) for more information.

Create a data view. Data views identify the Elasticsearch data you want to explore and visualize. They can point to one or more data streams, indices, or index aliases, and use optional runtime fields to compute values at query time. Note that data views are not required for ES|QL-based visualizations. To learn more, refer to the [data views documentation](https://www.elastic.co/docs/explore-analyze/find-and-organize/data-views).

## Headers

- `kbn-xsrf` string, required

## Request body

- DataViewsCreateDataViewRequestObject
  - `data_view` object, required — The data view object.
    - `allowNoIndex` boolean — Allows the data view saved object to exist before the data is available. Defaults to `false`.
    - `fieldAttrs` object
    - `fieldFormats` DataViewsFieldformats — A map of field formats by field name.
    - `fields` object
    - `id` string
    - `name` string — The data view name.
    - `namespaces` string[] — An array of space identifiers for sharing the data view between multiple spaces.
    - `runtimeFieldMap` object
    - `sourceFilters` object[] — The array of field names you want to filter out in Discover.
      - `value` string, required
    - `timeFieldName` string — The timestamp field name, which you use for time-based data views.
    - `title` string, required — Comma-separated list of data streams, indices, and aliases that you want to search. Supports wildcards (`*`).
    - `type` string — When set to `rollup`, identifies the rollup data views.
    - `typeMeta` DataViewsTypemeta — When you use rollup indices, contains the field list for the rollup data view API endpoints.
      - `aggs` object, required — A map of rollup restrictions by aggregation type and field name.
      - `params` object, required — Properties for retrieving rollup fields.
    - `version` string
  - `override` boolean — Override an existing data view if a data view with the provided title already exists.

## Response `200`

Indicates a successful call.

- DataViewsDataViewResponseObject
  - `data_view` object
    - `allowNoIndex` boolean — Allows the data view saved object to exist before the data is available. Defaults to `false`.
    - `fieldAttrs` object
    - `fieldFormats` DataViewsFieldformats — A map of field formats by field name.
    - `fields` object
    - `id` string
    - `name` string — The data view name.
    - `namespaces` string[] — An array of space identifiers for sharing the data view between multiple spaces.
    - `runtimeFieldMap` object
    - `sourceFilters` object[] — The array of field names you want to filter out in Discover.
      - `value` string, required
    - `timeFieldName` string — The timestamp field name, which you use for time-based data views.
    - `title` string — Comma-separated list of data streams, indices, and aliases that you want to search. Supports wildcards (`*`).
    - `typeMeta` DataViewsTypemetaResponse, nullable — When you use rollup indices, contains the field list for the rollup data view API endpoints.
      - `aggs` object — A map of rollup restrictions by aggregation type and field name.
      - `params` object — Properties for retrieving rollup fields.
    - `version` string

## Other responses

- `400` — Bad request

---

[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/531c9e2a7d23/schema)