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

# Equipes

> Convide e gerencie membros da equipe e convites no seu espaço de trabalho

Os comandos de equipe permitem convidar membros para o seu espaço de trabalho, listar os membros atuais e os convites
pendentes, alterar a função e a configuração de aprovação de posts de um membro, remover membros e cancelar
convites.

> [!NOTE]
>
> Todos os comandos aceitam as [flags globais](/pt-BR/cli/overview.md#opções-globais): `--json` (padrão) /
> `--table`, `--verbose`, `--api-key <key>` e `--api-url <url>`. Você também pode se autenticar com
> as variáveis de ambiente `SOME_API_KEY` e `SOME_API_URL`.

> [!NOTE]
>
> As **funções** são `member` ou `owner`. A **aprovação de posts** é `requires_approval` ou `auto_approve` e
> controla se os posts do membro precisam ser aprovados antes de serem publicados.

## teams:list

Lista os membros do seu espaço de trabalho.

```bash theme={null}
so-me teams:list [options]
```

| Opção | Descrição | Padrão |
| - | - | - |
| `--page <number>` | Número da página | `1` |
| `--limit <number>` | Itens por página | `50` |

```bash Exemplos theme={null}
# Saída JSON padrão
so-me teams:list

# Visualização em tabela
so-me teams:list --table

# Paginar
so-me teams:list --page 2 --limit 100

# Listar somente os proprietários via jq
so-me teams:list --limit 100 | jq '.data[] | select(.role == "owner")'
```

## teams:invite

Convida um novo membro da equipe por e-mail.

```bash theme={null}
so-me teams:invite --email <email> [options]
```

| Opção | Descrição | Padrão |
| - | - | - |
| `--email <email>` | Endereço de e-mail a convidar **(obrigatório)** | — |
| `--role <role>` | Função do membro: `member` ou `owner` | `member` |
| `--post-approval <approval>` | Aprovação de posts: `requires_approval` ou `auto_approve` | padrão do servidor |

> [!NOTE]
>
> O valor de `--role` é validado em relação a `member` / `owner` e convertido para minúsculas antes de ser enviado. Se
> `--post-approval` for omitida, o backend aplica a configuração de aprovação padrão.

```bash Exemplos theme={null}
# Convidar com as configurações padrão (função member)
so-me teams:invite --email alice@example.com

# Convidar um proprietário
so-me teams:invite --email bob@example.com --role owner

# Convidar um membro que pode publicar sem aprovação
so-me teams:invite --email carol@example.com --role member --post-approval auto_approve

# Convidar um membro cujos posts exigem aprovação
so-me teams:invite --email dan@example.com --post-approval requires_approval
```

## teams:invitations

Lista os convites de equipe pendentes.

```bash theme={null}
so-me teams:invitations [options]
```

| Opção | Descrição | Padrão |
| - | - | - |
| `--page <number>` | Número da página | `1` |
| `--limit <number>` | Itens por página | `50` |

```bash Exemplos theme={null}
# Saída JSON padrão
so-me teams:invitations

# Visualização em tabela
so-me teams:invitations --table

# Paginar
so-me teams:invitations --page 2 --limit 100
```

## teams:update

Atualiza a função e/ou a configuração de aprovação de posts de um membro da equipe. Você precisa informar `--role`,
`--post-approval` ou ambas; o comando falha se nenhuma for informada.

```bash theme={null}
so-me teams:update <id-or-email> [options]
```

**id-or-email** `string` *required*

O ID ou o endereço de e-mail do membro.

| Opção | Descrição |
| - | - |
| `--role <role>` | Função do membro: `owner` ou `member` |
| `--post-approval <approval>` | Aprovação de posts: `requires_approval` ou `auto_approve` |

> [!NOTE]
>
> Quando você altera apenas `--post-approval` (sem `--role`), a CLI primeiro procura o membro na
> lista da sua equipe para preservar a função existente, já que o endpoint subjacente sempre exige uma
> função. Os valores de `--role` e `--post-approval` são validados antes de a requisição ser enviada.

```bash Exemplos theme={null}
# Promover um membro a proprietário
so-me teams:update alice@example.com --role owner

# Mudar um membro para aprovação automática (a função é preservada automaticamente)
so-me teams:update alice@example.com --post-approval auto_approve

# Atualizar a função e a aprovação de posts juntas
so-me teams:update bob@example.com --role member --post-approval requires_approval

# Atualizar pelo ID do membro
so-me teams:update 550e8400-e29b-41d4-a716-446655440000 --role owner
```

## teams:remove

Remove um membro da equipe do espaço de trabalho. Será pedida uma confirmação, a menos que você passe `-y, --yes`.

```bash theme={null}
so-me teams:remove <id-or-email> [options]
```

**id-or-email** `string` *required*

O ID ou o endereço de e-mail do membro.

| Opção | Descrição |
| - | - |
| `-y, --yes` | Ignora a confirmação |

```bash Exemplos theme={null}
# Remover um membro (pede confirmação)
so-me teams:remove alice@example.com

# Remover sem confirmação
so-me teams:remove alice@example.com -y

# Remover pelo ID do membro
so-me teams:remove 550e8400-e29b-41d4-a716-446655440000 --yes
```

## teams:cancel-invite

Cancela um convite pendente pelo ID ou e-mail. Será pedida uma confirmação, a menos que você passe `-y, --yes`.

```bash theme={null}
so-me teams:cancel-invite <id-or-email> [options]
```

**id-or-email** `string` *required*

O ID ou o endereço de e-mail do convite.

| Opção | Descrição |
| - | - |
| `-y, --yes` | Ignora a confirmação |

```bash Exemplos theme={null}
# Cancelar um convite (pede confirmação)
so-me teams:cancel-invite alice@example.com

# Cancelar sem confirmação
so-me teams:cancel-invite alice@example.com -y

# Cancelar todos os convites pendentes em um único pipeline
so-me teams:invitations --limit 100 \
  | jq -r '.data[].id' \
  | xargs -I {} so-me teams:cancel-invite {} -y
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.