> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Gerencie workspaces pela CLI

> Crie, consulte, saia e exclua workspaces da Square Cloud com squarecloud workspace, e escolha quais das suas aplicações cada workspace pode ver.

Um workspace compartilha aplicações com uma equipe. O `squarecloud workspace` também funciona como `squarecloud ws`. Todo comando recebe o ID do workspace, que o `workspace list` e o `workspace create` imprimem. Para adicionar pessoas, veja [Membros do workspace](/pt-br/cli-reference/workspace-members); a central de ajuda explica [o que cada membro pode fazer](https://help.squarecloud.app/pt-br/article/permissoes-em-areas-de-trabalho-colaboradores-1acoyrk/).

## `squarecloud workspace create`

```bash Uso theme={"system"}
squarecloud workspace create <name>
```

Cria um workspace e imprime o ID dele.

```bash theme={"system"}
squarecloud workspace create "My Team"
```

```bash Saída theme={"system"}
✓ Workspace My Team (<workspaceID>) created successfully
```

## `squarecloud workspace list`

```bash Uso theme={"system"}
squarecloud workspace list [--json]
```

Mostra o nome, o ID do workspace, a quantidade de membros, a quantidade de aplicações e a data de criação de cada workspace que é seu ou do qual você participa.

## `squarecloud workspace info`

```bash Uso theme={"system"}
squarecloud workspace info <workspaceID> [--json]
```

Mostra o ID do workspace, o nome, o dono e a data de criação, seguidos de uma tabela com os membros (nome, ID do membro, grupo e data de entrada) e de uma tabela com as aplicações compartilhadas (nome, ID da aplicação, linguagem e memória), quando houver.

## `squarecloud workspace app add`

```bash Uso theme={"system"}
squarecloud workspace app add <workspaceID> <appID>
```

Compartilha uma das suas aplicações com um workspace que é seu, para que os membros trabalhem nela. Um workspace comporta até 100 aplicações.

## `squarecloud workspace app remove`

```bash Uso theme={"system"}
squarecloud workspace app remove <workspaceID> <appID>
```

Para de compartilhar a aplicação com o workspace. Só o dono do workspace pode fazer isso.

## `squarecloud workspace leave`

```bash Uso theme={"system"}
squarecloud workspace leave <workspaceID> [-y]
```

| Flag | Descrição |
| - | - |
| `-y`, `--yes` | Pula a confirmação. |

Remove você de um workspace de outra pessoa, após uma confirmação `y/N`. O workspace continua existindo. O dono não pode sair do próprio workspace: nesse caso, exclua-o.

## `squarecloud workspace delete`

```bash Uso theme={"system"}
squarecloud workspace delete <workspaceID> [-y]
```

| Flag | Descrição |
| - | - |
| `-y`, `--yes` | Pula a confirmação. |

<Warning>
  Excluir um workspace é permanente: a lista de membros e o compartilhamento das aplicações vão junto. As aplicações em si continuam nas contas dos donos delas.
</Warning>

Só o dono pode excluir um workspace. O comando pede uma confirmação `y/N` antes.

## Relacionados

| Comando | API | SDK JavaScript | VS Code |
| - | - | - | - |
| `create` | [`POST /v2/workspaces`](/pt-br/api-reference/endpoint/workspace/create) | [`api.workspaces.create()`](/pt-br/sdks/js/workspaces) | [Criar workspace](/pt-br/vscode-extension/features#workspaces) |
| `list` | [`GET /v2/workspaces`](/pt-br/api-reference/endpoint/workspace/list) | [`api.workspaces.list()`](/pt-br/sdks/js/workspaces) | [Seção Workspaces](/pt-br/vscode-extension/features#workspaces) |
| `info` | [`GET /v2/workspaces/{workspaceId}`](/pt-br/api-reference/endpoint/workspace/get) | [`api.workspaces.get()`](/pt-br/sdks/js/workspaces) | |
| `app add` | [`POST .../applications`](/pt-br/api-reference/endpoint/workspace/apps/add) | [`api.workspaces.apps.add()`](/pt-br/sdks/js/workspaces) | |
| `app remove` | [`DELETE .../applications`](/pt-br/api-reference/endpoint/workspace/apps/remove) | [`api.workspaces.apps.remove()`](/pt-br/sdks/js/workspaces) | |
| `leave` | [`DELETE /v2/workspaces/leave`](/pt-br/api-reference/endpoint/workspace/leave) | [`api.workspaces.leave()`](/pt-br/sdks/js/workspaces) | [Sair do workspace](/pt-br/vscode-extension/features#workspaces) |
| `delete` | [`DELETE /v2/workspaces`](/pt-br/api-reference/endpoint/workspace/delete) | [`api.workspaces.delete()`](/pt-br/sdks/js/workspaces) | [Excluir workspace](/pt-br/vscode-extension/features#workspaces) |