Create runtime field API

edit

Create runtime field API

edit

[preview] This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. Create a runtime field

Request

edit

POST <kibana host>:<port>/api/data_views/data_view/<data_view_id>/runtime_field

POST <kibana host>:<port>/s/<space_id>/api/data_views/data_view/<data_view_id>/runtime_field

Path parameters

edit
space_id
(Optional, string) An identifier for the space. If space_id is not provided in the URL, the default space is used.
data_view_id
(Required, string) The ID of the data view.

Request body

edit
name
(Required, string) The name for a runtime field.
runtimeField
(Required, object) The runtime field definition object.

Examples

edit

Create a runtime field on a data view:

$ curl -X POST api/data_views/data_view/<data_view_id>/runtime_field
{
  "name": "runtimeFoo",
  "runtimeField": {
     "type": "long",
     "script": {
        "source": "emit(doc["foo"].value)"
      }
  }
}

The API returns created runtime field object array and updated data view object:

{
    "data_view": {...},
    "fields": [...]
}