IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.

› › ›

Update space API

edit

Update space 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. Update an existing Kibana space.

Request

edit

PUT <kibana host>:<port>/api/spaces/space/<space_id>

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.
imageUrl: (Optional, string) Specifies the data-url encoded image to display in the space avatar. If specified, initials will not be displayed, and the color will be visible as the background color for transparent images. For best results, your image should be 64x64. Images will not be optimized by this API call, so care should be taken when using custom images.

Response codes

edit

200: Indicates a successful call.

Example

edit

$ curl -X PUT api/spaces/space/marketing
{
  "id": "marketing",
  "name": "Marketing",
  "description" : "This is the Marketing Space",
  "color": "#aabbcc",
  "initials": "MK",
  "disabledFeatures": [],
  "imageUrl": ""
}

« Create space API Get a space API »