> For the complete documentation index, see [llms.txt](https://docs.umbraco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.umbraco.com/umbraco-automate/18.latest/backoffice/workspaces.md).

# Manage Workspaces

A workspace groups related automations and controls which connections and users have access. See [Workspaces](/umbraco-automate/18.latest/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/7QCkT7hqYJp9476g48ji" 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/18.latest/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/KjIaTXhZwDhxxgqytsqg" 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/18.latest/concepts/workspaces.md)
* [Managing Connections](/umbraco-automate/18.latest/backoffice/connections.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.