50 lines
1.7 KiB
Text
50 lines
1.7 KiB
Text
[[spaces-api-post]]
|
|
=== Create Space
|
|
|
|
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.
|
|
|
|
==== Request
|
|
|
|
To create a space, issue a POST request to the
|
|
`/api/spaces/space` endpoint.
|
|
|
|
[source,js]
|
|
--------------------------------------------------
|
|
POST /api/spaces/space
|
|
--------------------------------------------------
|
|
|
|
==== Request Body
|
|
|
|
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.
|
|
|
|
===== Example
|
|
|
|
[source,js]
|
|
--------------------------------------------------
|
|
POST /api/spaces/space
|
|
{
|
|
"id": "marketing",
|
|
"name": "Marketing",
|
|
"description" : "This is the Marketing Space",
|
|
"color": "#aabbcc",
|
|
"initials": "MK"
|
|
}
|
|
--------------------------------------------------
|
|
// KIBANA
|
|
|
|
==== Response
|
|
|
|
A successful call returns a response code of `200` with the created Space.
|