Configuring workspaces in Management API

This article documents how to configure workspaces with the Management API.

Retrieving information about existing workspace

To retrieve information about an existing workspace, follow these steps:

Create a GET request to the following endpoint:
```
https://{{INSTANCE}}/api/stacks/{{STACK_SLUG}}
```
{{STACK_SLUG}}: Represents a slugified name of your workspace. Find the {{STACK_SLUG}} as value of parameter slug in the response of the API call where you list existing workspaces. To obtain this API response, follow the procedure in Listing existing workspaces.
In the HTTP request header, include the parameter Authorization with one of the following values:
- Token {{KEY}} if you use a key generated with user credentials in Management API.
- Bearer {{KEY}} if you use a key generated in the Adverity user interface.
In the HTTP request header, include the parameter Content-Type with value application/json.
Send the request.

As a result, you retrieved information about a workspace. Use the retrieved information to edit the workspace configuration in the following section Configuring a workspace in Management API.

Import the request example as raw text to your HTTP client (such as Postman). The cURL request example is the following:

curl --location --request GET 'https://{{INSTANCE}}/api/stacks/{{STACK_SLUG}}' \
--header 'Authorization: Token {{KEY}}' \
--header 'Content-Type: application/json'

Configuring a workspace in Management API

The following procedure explains how to change the parent workspace for your selected workspace. You can edit other options as the name of your workspace.

To configure your workspace through the Management API, follow these steps:

Create a PATCH request to the following endpoint:
```
https://{{INSTANCE}}/api/stacks/{{STACK_SLUG}}/
```
In the HTTP request header, include the parameter Authorization with one of the following values:
- Token {{KEY}} if you use a key generated with user credentials in Management API.
- Bearer {{KEY}} if you use a key generated in the Adverity user interface.
In the HTTP request header, include the parameter Content-Type with value application/json.
In the HTTP request body, include the following code as raw JSON input, and then replace the red values as necessary.
```
{"parent_id":PARENT_ID}
```
Replace PARENT_ID with the parent workspace ID. This means that another workspace becomes the parent of the workspace that you are configuring and inherits some of its configuration. Your workspace already has a default parent workspace. To find the PARENT_ID, search for the value of the parameter id in an API call described in the section Listing existing workspaces.
Send the request.

As a result, you changed the parent of the selected workspace. With this procedure, you can edit names of workspaces and other details.

Import the request example as raw text to your HTTP client (such as Postman). The cURL request example is the following:

curl --location --request PATCH 'https://{{INSTANCE}}/api/stacks/{{STACK_SLUG}}' \
--header 'Authorization: Token {{KEY}}' \
--header 'Content-Type: application/json' \
--data-raw '{"parent_id":PARENT_ID}'