IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.
« Create runtime field API Update runtime field API »
Elastic Docs ›Kibana Guide [8.11] ›REST API ›Data views API

Upsert runtime field API

edit

Upsert 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 or update an existing runtime field

Request

edit

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

PUT <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 new runtime field or a name of an existing runtime field.
runtimeField
(Required, object) The runtime field definition object.

Examples

edit

Create or update an existing runtime field on a data view:

$ curl -X PUT 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 or updated runtime field object array and updated data view object:

{
    "data_view": {...},
    "fields": [...]
}
« Create runtime field API Update runtime field API »