IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.
« Kibana Spaces APIs Update space API »
Elastic Docs ›Kibana Guide [7.4] ›REST API ›Kibana Spaces APIs

Create space API

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

Create space API

edit

Creates a Kibana space.

The underlying Spaces concepts are stable, but the APIs for managing Spaces are experimental.

Request

edit

POST /api/spaces/space

Request body

edit
id
(Required, string) The space ID that is part of the Kibana URL when inside the space. You are unable to change the ID with the update operation.
name
(Required, string) The display name for the space.
description
(Optional, string) The description for the space.
disabledFeatures
(Optional, string array) The list of disabled features for the space. To get a list of available feature IDs, use the Features API.
initials
(Optional, string) Specifies the initials shown in the space avatar. By default, the initials are automatically generated from the space name. Initials must be 1 or 2 characters.
color
(Optional, string) Specifies the hexadecimal color code used in the space avatar. By default, the color is automatically generated from the space name.

Response codes

edit
200
Indicates a successful call.

Example

edit
POST /api/spaces/space
{
  "id": "marketing",
  "name": "Marketing",
  "description" : "This is the Marketing Space",
  "color": "#aabbcc",
  "initials": "MK",
  "disabledFeatures": ["timelion"]
}
« Kibana Spaces APIs Update space API »