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

# Équipes

> Invitez et gérez les membres de l'équipe et les invitations dans votre espace de travail

Les commandes d'équipe vous permettent d'inviter des membres dans votre espace de travail, de lister les membres actuels et les invitations
en attente, de modifier le rôle et le réglage d'approbation des publications d'un membre, de retirer des membres et d'annuler des
invitations.

> [!NOTE]
>
> Toutes les commandes acceptent les [options globales](/fr/cli/overview.md#options-globales) : `--json` (par défaut) /
> `--table`, `--verbose`, `--api-key <key>` et `--api-url <url>`. Vous pouvez aussi vous authentifier avec
> les variables d'environnement `SOME_API_KEY` et `SOME_API_URL`.

> [!NOTE]
>
> Les **rôles** sont `member` ou `owner`. L'**approbation des publications** est `requires_approval` ou `auto_approve` et
> détermine si les publications du membre doivent être approuvées avant leur publication.

## teams:list

Liste les membres de votre espace de travail.

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

| Option | Description | Par défaut |
| - | - | - |
| `--page <number>` | Numéro de page | `1` |
| `--limit <number>` | Éléments par page | `50` |

```bash Exemples theme={null}
# Default JSON output
so-me teams:list

# Table view
so-me teams:list --table

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

# List only owners via jq
so-me teams:list --limit 100 | jq '.data[] | select(.role == "owner")'
```

## teams:invite

Invite un nouveau membre de l'équipe par e-mail.

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

| Option | Description | Par défaut |
| - | - | - |
| `--email <email>` | Adresse e-mail à inviter **(obligatoire)** | — |
| `--role <role>` | Rôle du membre : `member` ou `owner` | `member` |
| `--post-approval <approval>` | Approbation des publications : `requires_approval` ou `auto_approve` | valeur par défaut du serveur |

> [!NOTE]
>
> La valeur de `--role` est validée par rapport à `member` / `owner` et mise en minuscules avant l'envoi. Si
> `--post-approval` est omis, le backend applique son réglage d'approbation par défaut.

```bash Exemples theme={null}
# Invite with default settings (member role)
so-me teams:invite --email alice@example.com

# Invite an owner
so-me teams:invite --email bob@example.com --role owner

# Invite a member who can publish without approval
so-me teams:invite --email carol@example.com --role member --post-approval auto_approve

# Invite a member whose posts require approval
so-me teams:invite --email dan@example.com --post-approval requires_approval
```

## teams:invitations

Liste les invitations d'équipe en attente.

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

| Option | Description | Par défaut |
| - | - | - |
| `--page <number>` | Numéro de page | `1` |
| `--limit <number>` | Éléments par page | `50` |

```bash Exemples theme={null}
# Default JSON output
so-me teams:invitations

# Table view
so-me teams:invitations --table

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

## teams:update

Met à jour le rôle et/ou le réglage d'approbation des publications d'un membre de l'équipe. Vous devez fournir `--role`,
`--post-approval` ou les deux — la commande échoue si aucun n'est indiqué.

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

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

L'ID ou l'adresse e-mail du membre.

| Option | Description |
| - | - |
| `--role <role>` | Rôle du membre : `owner` ou `member` |
| `--post-approval <approval>` | Approbation des publications : `requires_approval` ou `auto_approve` |

> [!NOTE]
>
> Lorsque vous ne modifiez que `--post-approval` (sans `--role`), la CLI recherche d'abord le membre dans
> la liste de votre équipe pour conserver son rôle actuel, car l'endpoint sous-jacent exige toujours un
> rôle. Les valeurs de `--role` et de `--post-approval` sont validées avant l'envoi de la requête.

```bash Exemples theme={null}
# Promote a member to owner
so-me teams:update alice@example.com --role owner

# Switch a member to auto-approve (role preserved automatically)
so-me teams:update alice@example.com --post-approval auto_approve

# Update role and post-approval together
so-me teams:update bob@example.com --role member --post-approval requires_approval

# Update by member ID
so-me teams:update 550e8400-e29b-41d4-a716-446655440000 --role owner
```

## teams:remove

Retire un membre de l'équipe de l'espace de travail. Une confirmation vous est demandée, sauf si vous passez `-y, --yes`.

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

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

L'ID ou l'adresse e-mail du membre.

| Option | Description |
| - | - |
| `-y, --yes` | Ignore la demande de confirmation |

```bash Exemples theme={null}
# Remove a member (prompts for confirmation)
so-me teams:remove alice@example.com

# Remove without confirmation
so-me teams:remove alice@example.com -y

# Remove by member ID
so-me teams:remove 550e8400-e29b-41d4-a716-446655440000 --yes
```

## teams:cancel-invite

Annule une invitation en attente à partir de son ID ou de son e-mail. Une confirmation vous est demandée, sauf si vous passez `-y, --yes`.

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

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

L'ID ou l'adresse e-mail de l'invitation.

| Option | Description |
| - | - |
| `-y, --yes` | Ignore la demande de confirmation |

```bash Exemples theme={null}
# Cancel an invitation (prompts for confirmation)
so-me teams:cancel-invite alice@example.com

# Cancel without confirmation
so-me teams:cancel-invite alice@example.com -y

# Cancel all pending invitations in one 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.