# Workspace

## What are Workspaces?

A workspace is what holds all of your data—members, projects, secrets, integrations, etc. You can think of it as an organization, which ties up everything related to a business. You get a default workspace when you first register to keyshade.

A workspace allows you to do the following things:

* Create projects
* Add and manage secrets, variables and environments in these projects
* Create integrations that tie up your external services with keyshade
* Invite and manage members of your organization
* Implement RBAC via roles management
* Upgrade your workspace tier
* Manage billing and subscription

A user can have an unlimited number of workspaces for free.

## Organizing your data

Each workspace is meant to hold data related to a single project, or organization. This means that projects related to a single application or organization should be container in a single workspace.

## The default workspace

When you first register on Keyshade, you get a default workspace. This is where you land when you first log in. The default workspace is meant for personal use, hosting portfolio projects and such. We do not support any payments or subscriptions for the default workspace.

## Supported Functionalities

### Creating a workspace

{% tabs %}
{% tab title="Web" %}

* Head over to the dashboard at [app.keyshade.io](https://app.keyshade.io)
* Navigate to the bottom in the left sidebar and click on the combobox

  ![select combobox](/files/9pwR5QDzL5GMlwAUaDK7)
* Click on **Create a New Workspace**
* Enter the name of the workspace

  ![create workspace dialog](/files/Ifh6rlMeBLxqSb6E2Gx1)
* Click on **Add Workspace**
* And then, you can select your new workspace

  ![created workspace](/files/pgNsgOJIJFlEXXq3bOQ4)
  {% endtab %}

{% tab title="CLI" %}

* Create the workspace

  ```shell
  keyshade workspace create -n <workspace-name>
  ```
* Once done, you can verify that the workspace was created

  ```shell
  keyshade workspace list
  ```

{% endtab %}
{% endtabs %}

### Updating a workspace

{% tabs %}
{% tab title="Web" %}

* From the sidebar, select the workspace that you want to edit
* Click on **Settings**
* Update the information and click on **Save Changes**
  {% endtab %}

{% tab title="CLI" %}

* To update the workspace name, run

  ```shell
  keyshade workspace update <workspace-slug> -n <workspace-name>
  ```

{% endtab %}
{% endtabs %}

### Deleting a workspace

{% tabs %}
{% tab title="Web" %}

* From the sidebar, select the workspace that you want to delete
* Click on **Settings**
* Scroll down, and select "Delete Workspace"
* Enter the name of your workspace to confirm your action
* Click on **Yes, delete the workspace**
  {% endtab %}

{% tab title="CLI" %}

* To update the workspace name, run

  ```shell
  keyshade workspace delete <workspace-slug>
  ```

{% endtab %}
{% endtabs %}


---

# 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.keyshade.io/app-reference/workspace.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.