NOTE: You are looking at documentation for an older release. For the latest information, see the current release documentation.

› › ›

Create Object

IMPORTANT: This documentation is no longer updated. Refer to Elastic's version policy and the latest documentation.

This functionality is experimental and may be changed or removed completely in a future release.

The create saved object API enables you to persist a Kibana saved object.

POST /api/saved_objects/<type>

POST /api/saved_objects/<type>/<id>

type (required): (string) Valid options, include: visualization, dashboard, search, index-pattern, config, and timelion-sheet
id (optional): (string) Enables specifying an ID to use, as opposed to one being randomly generated

overwrite (optional): (boolean) If true, will overwrite the document with the same ID.

The following example creates an index pattern object with a pattern of my-pattern-*.

POST api/saved_objects/index-pattern/my-pattern
{
  "attributes": {
    "title": "my-pattern-*"
  }
}

A successful call returns a response code of 200 and a response body containing a JSON structure similar to the following example:

{
  "id": "my-pattern", 
  "type": "index-pattern",
  "version": 1,
  "attributes": {
    "title": "my-pattern-*"
  }
}

If my-pattern was not specified in the path, a unique ID would have been generated.

Attributes are not validated at creation time. This means you can pass arbitrary and ill-formed data into this API that can break Kibana. Make sure any data you send to this API is properly formed.