> For the complete documentation index, see [llms.txt](https://docs.keyshade.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keyshade.io/app-reference/workspace.md).

# Workspace

Explainer on what workspaces are and how to use them

## 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](https://3494620841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1uANBbw2pha5LMTqtGvX%2Fuploads%2Fgit-blob-d061193601a4b2e49c321f34fbfb26e13cbace10%2Fcombobox-click.png?alt=media)
* Click on **Create a New Workspace**
* Enter the name of the workspace

  ![create workspace dialog](https://3494620841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1uANBbw2pha5LMTqtGvX%2Fuploads%2Fgit-blob-7262ab0f8d5a7796c965efb8aebf503f99e11345%2Fcreate-workspace-dialog.png?alt=media)
* Click on **Add Workspace**
* And then, you can select your new workspace

  ![created workspace](https://3494620841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1uANBbw2pha5LMTqtGvX%2Fuploads%2Fgit-blob-d2afbfb7e2ada0190aac4010c7f032a0017f0f96%2Fcreated-workspace.png?alt=media)
  {% 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
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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.keyshade.io/app-reference/workspace.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.