kibana/docs/api/spaces-management/put.asciidoc
elena-shostak 3d09eaa6fc
[Spaces] Passing default solution from cloud onboarding process (#185926)
## Summary

Passing default solution from cloud onboarding process.

1. Renaming. Solution changes are not released yet, would be shipped
with `8.15`, so it's fine to do it.
   - `search` -> `es`
   - `observability` -> `oblt`
   - Adjusted telemetry accordingly
2. Added `cloud` as optional dependency to `spaces` plugin to use
`onboarding.defaultSolution` passed through setup contract.

### How to test
1. Set `xpack.cloud.onboarding.default_solution` to `es | oblt |
security`
2. Check that default space was created with provided solution `GET
kbn:/api/spaces/space/default`

### Checklist

- [x]
[Documentation](https://www.elastic.co/guide/en/kibana/master/development-documentation.html)
was added for features that require explanation or tutorials
- [x] [Unit or functional
tests](https://www.elastic.co/guide/en/kibana/master/development-tests.html)
were updated or added to match the most common scenarios


### For maintainers

- [x] This was checked for breaking API changes and was [labeled
appropriately](https://www.elastic.co/guide/en/kibana/master/contributing.html#kibana-release-notes-process)

__Fixes: https://github.com/elastic/kibana/issues/184999__

---------

Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com>
2024-06-18 11:10:52 +02:00

64 lines
2 KiB
Text

[[spaces-api-put]]
=== Update space API
++++
<titleabbrev>Update space</titleabbrev>
++++
experimental[] Update an existing {kib} space.
[[spaces-api-put-api-request]]
==== Request
`PUT <kibana host>:<port>/api/spaces/space/<space_id>`
[[spaces-api-put-request-body]]
==== Request body
`id`::
(Required, string) The space ID that is part of the {kib} 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-get, 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.
`solution`::
(Optional, string) The solution defined for the space. Can be one of `security`, `oblt`, `es`, `classic`.
[[spaces-api-put-response-codes]]
==== Response codes
`200`::
Indicates a successful call.
[[sample-api-example]]
==== Example
[source,sh]
--------------------------------------------------
$ curl -X PUT api/spaces/space/marketing
{
"id": "marketing",
"name": "Marketing",
"description" : "This is the Marketing Space",
"color": "#aabbcc",
"initials": "MK",
"disabledFeatures": [],
"imageUrl": ""
}
--------------------------------------------------
// KIBANA