# Creating, editing, or deleting a workspace

## Creating a workspace <a href="#workspaces-create-options" id="workspaces-create-options"></a>

When you create a new workspace, you can either:

* [Create a completely new workspace.](#workspace-create-new)
* [Create a copy of an existing workspace.](#workspace-create-copy)\
  \
  The copy initially uses the configuration from the original workspace.\
  \
  After the copy is created, it is completely independent from the original workspace.
* [Create a child of an existing workspace.](#workspace-create-child)\
  \
  Child workspaces inherit configuration from the parent workspace. They continue to be updated automatically when the parent workspace is updated. For more information, go to [About workspace inheritance](/app/workspace/managing-workspaces/workspaces-inheritance.md).

You can also view this [video overview of how to create a workspace](https://youtu.be/iH-wBYJLQlk).

When you create a workspace, a new [Structural Agent](/app/structural-agent/agent-about.md) chat starts for the workspace.

### Creating a completely new workspace <a href="#workspace-create-new" id="workspace-create-new"></a>

{% hint style="info" %}
**Required global permission:** Create workspaces
{% endhint %}

To create a completely new workspace, on **Workspaces** view, click **Create Workspace > New Workspace**.

For information about the configuration settings for a workspace, go to [Workspace configuration settings](/app/workspace/workspace-configuration-settings.md).

### Creating a copy of a workspace <a href="#workspace-create-copy" id="workspace-create-copy"></a>

{% hint style="info" %}
**Required workspace permission:** Copy workspace (in the workspace to copy)

Or

**Required global permission:** Copy any workspace
{% endhint %}

To create a workspace based on an existing workspace, either:

* On the workspace management view of the workspace to copy, from the workspace actions menu, select **Duplicate Workspace**.

<figure><img src="/files/j7hcNZPM1IRDBiN3JMbd" alt=""><figcaption><p>Workspace actions menu</p></figcaption></figure>

* On **Workspaces** view, click the actions menu for the workspace, then select **Duplicate Workspace**.

![Workspace options column and dropdown list](/files/39M0yYtXgiLtBPn7OdH1)

When you create a copy of a workspace, the copy initially inherits the following workspace configuration:

* Source and destination database connections
* Sensitivity designations, including manual designations that override the sensitivity scan results
* Table mode assignments
* Generator configuration
* Subsetting configuration
* Post-job scripts

### Creating a child workspace <a href="#workspace-create-child" id="workspace-create-child"></a>

{% hint style="info" %}
**Required license:** Enterprise

**Required workspace permission:** Create child workspaces (in the parent workspace)
{% endhint %}

You can create a workspace that is a child of an existing workspace. You cannot create a child workspace of another child workspace.

The parent workspace must have a source database configured. You cannot create a child workspace from a workspace that uses the Databricks, self-managed Spark cluster, or MongoDB data connector.

To create a child workspace, either:

* On **Workspaces** view:
  * Click **Create Workspace > Child Workspace**.
  * Click the actions menu for the parent workspace, then select **Create Child Workspace**.
* On the workspace management view, from the workspace actions menu, select **Create Child Workspace**.

On the **New Workspace** view, under **Child Workspace**, **Parent Workspace** identifies the parent workspace.

If you used the **Create Workspace > Child Workspace** option to create the child workspace, then **Parent Workspace** is not populated. From the **Parent Workspace** dropdown list, select the parent workspace for the new child workspace.

If you selected the child workspace option for a specific workspace, then **Parent Workspace** is set to that workspace.

<figure><img src="/files/FDuEVgQBW3PwdPOhrwAW" alt=""><figcaption><p>New Child Workspace view for a child workspace</p></figcaption></figure>

If you originally chose to create a completely new workspace, then on the **New Workspace** view:

<figure><img src="/files/UrpTzHlEpZXWP1Nh58RD" alt=""><figcaption><p>Create Child Workspace option on the New Workspace view</p></figcaption></figure>

1. To change to a child workspace, select **Create Child Workspace** from the **Create a child workspace** panel at the right.\
   \
   Structural adds the **Child Workspace** panel to the **New Workspace** view.
2. From the **Parent Workspace** dropdown list, select the parent workspace for the new child workspace.

## Editing a workspace <a href="#workspaces-edit" id="workspaces-edit"></a>

{% hint style="info" %}
**Required workspace permission:** Configure workspace settings
{% endhint %}

To edit the configuration for an existing workspace, either:

* On the workspace management view:
  * On the workspace navigation bar, click **Workspace Settings**.
  * From the workspace actions menu, select **Workspace Settings**.
* On **Workspaces** view, click the actions menu for the workspace, then select **Workspace Settings**.

## Deleting a workspace <a href="#workspaces-delete" id="workspaces-delete"></a>

{% hint style="info" %}
**Required workspace permission:** Delete workspace
{% endhint %}

You can delete workspaces that you no longer need.

You cannot delete a parent workspace. You must first delete all of its child workspaces.

To delete a workspace:

* On the workspace management view, from the workspace actions menu, select **Delete Workspace**.
* On the **Workspaces** view, click the actions menu for the workspace, then select **Delete**.
* On the **Workspace Settings** view, click **Delete Workspace**.


---

# 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.tonic.ai/app/workspace/managing-workspaces/workspaces-create-edit-delete.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.