> ## 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.

# Membros do workspace pela CLI

> Convide pessoas para um workspace da Square Cloud com um código de uso único, mude o grupo de permissão delas e remova-as com squarecloud workspace member.

As pessoas entram em um workspace com um código de convite que elas mesmas geram:

<Steps>
  <Step title="O novo membro gera um código">
    A pessoa que quer entrar executa `squarecloud workspace member invite-code` e envia o código para o dono do workspace. O código funciona uma vez e expira após 5 minutos.
  </Step>

  <Step title="O dono adiciona a pessoa">
    O dono executa `squarecloud workspace member add` com o ID do workspace, o código e um grupo de permissão.
  </Step>
</Steps>

## Grupos de permissão

O `<group>` é um destes:

| Grupo | O que o membro pode fazer |
| - | - |
| `admin` | Controle total das aplicações compartilhadas, incluindo variáveis de ambiente, snapshots, domínios personalizados e configurações de deploy. |
| `maintain` | Trabalho operacional: commits, iniciar, parar e reiniciar, arquivos, DNS e limpeza de cache. |
| `manager` | Monitoramento e controle: iniciar, parar e reiniciar, e informações de deploy. Sem commits, arquivos ou alterações de rede. |
| `view` | Somente leitura. |

O grupo do próprio dono é `owner`, que não pode ser dado a mais ninguém. A central de ajuda tem mais sobre as [permissões em workspaces](https://help.squarecloud.app/pt-br/article/permissoes-em-areas-de-trabalho-colaboradores-1acoyrk/).

## `squarecloud workspace member invite-code`

```bash Uso theme={"system"}
squarecloud workspace member invite-code
```

Gera o seu próprio código de convite de uso único, válido por 5 minutos.

```bash Saída theme={"system"}
Your invite code (single-use, valid for 5 minutes):
  <inviteCode>
```

## `squarecloud workspace member add`

```bash Uso theme={"system"}
squarecloud workspace member add <workspaceID> <inviteCode> <group>
```

Adiciona ao workspace a pessoa que gerou o `<inviteCode>`, com o grupo de permissão informado. Só o dono do workspace pode adicionar membros, até o limite de membros do plano do dono.

```bash theme={"system"}
squarecloud workspace member add <workspaceID> <inviteCode> maintain
```

## `squarecloud workspace member update`

```bash Uso theme={"system"}
squarecloud workspace member update <workspaceID> <memberID> <group>
```

Muda o grupo de permissão de um membro. Pegue o ID do membro no [`workspace info`](/pt-br/cli-reference/workspaces#squarecloud-workspace-info).

## `squarecloud workspace member remove`

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

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

Remove um membro do workspace, após uma confirmação `y/N`. Só o dono do workspace pode remover membros. Para você mesmo sair de um workspace, use o [`workspace leave`](/pt-br/cli-reference/workspaces#squarecloud-workspace-leave).

## Relacionados

| Comando | API | SDK JavaScript | VS Code |
| - | - | - | - |
| `invite-code` | [`GET .../members/code`](/pt-br/api-reference/endpoint/workspace/members/code) | [`api.workspaces.members.inviteCode()`](/pt-br/sdks/js/workspaces) | [Copiar meu código de convite](/pt-br/vscode-extension/features#workspaces) |
| `add` | [`POST .../members`](/pt-br/api-reference/endpoint/workspace/members/invite) | [`api.workspaces.members.add()`](/pt-br/sdks/js/workspaces) | |
| `update` | [`PATCH .../members`](/pt-br/api-reference/endpoint/workspace/members/perms) | [`api.workspaces.members.update()`](/pt-br/sdks/js/workspaces) | |
| `remove` | [`DELETE .../members`](/pt-br/api-reference/endpoint/workspace/members/kick) | [`api.workspaces.members.remove()`](/pt-br/sdks/js/workspaces) | |