experimental[This API is experimental and may be changed or removed completely in a future release. The underlying Spaces concepts are stable, but the APIs for managing Spaces are currently experimental.]
Creates a new {kib} space. To update an existing space, use the PUT command.
To create a space, issue a POST request to the
/api/spaces/space
endpoint.
POST /api/spaces/space
The following parameters can be specified in the body of a POST request to create a space:
id
-
(string) Required identifier for the space. This identifier becomes part of Kibana’s URL when inside the space. This cannot be changed by the update operation.
name
-
(string) Required display name for the space.
description
-
(string) Optional description for the space.
initials
-
(string) Optionally specify the initials shown in the Space Avatar for this space. By default, the initials will be automatically generated from the space name. If specified, initials should be either 1 or 2 characters.
color
-
(string) Optioanlly specify the hex color code used in the Space Avatar for this space. By default, the color will be automatically generated from the space name.