# Manage Workspaces

A workspace groups related automations and controls which connections and users have access. See [Workspaces](/umbraco-automate/concepts/workspaces.md) for the underlying concept.

## Create a Workspace

1. Open the **Automate** section.
2. Right-click the root of the tree.
3. Select **Create workspace**.
4. Enter a name and click **Create**.

<figure><img src="/files/AhnuhCYGJrfow94fmvEc" alt="The create workspace modal."><figcaption><p>Creating a workspace.</p></figcaption></figure>

## Workspace Editor

Open a workspace from the tree. The workspace editor has two tabs:

| Tab          | Purpose                                                                        |
| ------------ | ------------------------------------------------------------------------------ |
| **Settings** | Configure the workspace service account, user groups, and allowed connections. |
| **Info**     | View the workspace version history, ID, and alias.                             |

### Settings

The **Settings** tab has three fields:

| Field                   | Purpose                                                                                                                                                                                                                                                                                                                     |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Service Account**     | The Umbraco user identity that the automations in this workspace run as. Required. The account's section access, start node, and per-resource membership decide which triggers and actions the workspace can use — see [Service-Account Permissions](/umbraco-automate/concepts/workspaces.md#service-account-permissions). |
| **User Groups**         | The Umbraco user groups whose members can view, edit, and run the automations in this workspace. Required.                                                                                                                                                                                                                  |
| **Allowed Connections** | The connections that the automations in this workspace can use.                                                                                                                                                                                                                                                             |

<figure><img src="/files/aHwDIL7M9x06E7eElbNs" alt="The workspace Settings tab with the service account, user groups, and allowed connections fields."><figcaption><p>Configuring workspace settings.</p></figcaption></figure>

{% hint style="warning" %}
Changing the service account on a workspace with published automations can take them offline.

Events the new account isn't authorized for are silently skipped at dispatch. Actions that need permissions it doesn't have fail with an authentication error.

Review the **Runs** tab after any service-account change.
{% endhint %}

## Workspace Groups

Workspaces can be organized into **workspace groups** — folders in the tree. To create a workspace group, right-click the root of the tree and select **Create workspace group**. Workspace groups are organizational only; they do not affect access.

## Delete a Workspace

Right-click a workspace and select **Delete**. Deleting a workspace deletes its automations and run history.

{% hint style="warning" %}
Workspace deletion is permanent. Export any automations you want to keep before deleting.
{% endhint %}

## See Also

* [Workspaces](/umbraco-automate/concepts/workspaces.md)
* [Managing Connections](/umbraco-automate/backoffice/connections.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.umbraco.com/umbraco-automate/backoffice/workspaces.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.