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

# Comptes

> Connectez et gérez vos comptes de réseaux sociaux

Le groupe de commandes `accounts` vous permet de lister, inspecter, connecter et supprimer les comptes
sociaux de votre espace de travail. Toutes les commandes acceptent les options globales (`--json` par défaut,
`--table`, `--verbose`, `--api-key`, `--api-url`) et lisent les identifiants dans `SOME_API_KEY`
/ `SOME_API_URL` lorsque ces options sont omises.

## Plateformes prises en charge

Les commandes qui prennent une option `--platform` ou un argument `<platform>` acceptent les valeurs
suivantes. `x` est un alias de `twitter`.

| Valeur | Plateforme |
| - | - |
| `twitter` (ou `x`) | Twitter / X |
| `linkedin` | LinkedIn (personnel) |
| `linkedin_page` | Page LinkedIn |
| `instagram` | Instagram |
| `facebook` | Facebook |
| `tiktok` | TikTok |
| `youtube` | YouTube |
| `threads` | Threads |
| `pinterest` | Pinterest |
| `whatsapp` | WhatsApp |
| `dribbble` | Dribbble |

## accounts:list

Liste les comptes sociaux connectés de votre espace de travail. Les résultats sont paginés.

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

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

```bash Exemples theme={null}
# List the first page of accounts
so-me accounts:list

# Render as a table
so-me accounts:list --table

# Search by name with a larger page size
so-me accounts:list --search acme --limit 100 --page 1
```

## accounts:get

Récupère les détails d'un compte précis à partir de son ID, du nom de la plateforme ou de son nom d'utilisateur.

```bash theme={null}
so-me accounts:get <id-or-platform>
```

| Argument | Description |
| - | - |
| `<id-or-platform>` | UUID du compte, nom de plateforme (`twitter`, `linkedin`, etc.) ou nom d'utilisateur / nom du compte **(obligatoire)** |

Comportement de la résolution :

* **Nom de plateforme** — renvoie tous les comptes de cette plateforme. Lorsqu'un seul compte correspond,
  ce compte est renvoyé ; sinon, la liste complète des correspondances est renvoyée.
* **Nom d'utilisateur / nom du compte** — comparé au nom d'utilisateur ou au nom d'affichage du compte,
  puis récupéré à partir de l'ID résolu.
* **UUID** — lorsque l'argument est un UUID valide et qu'aucun nom d'utilisateur ne correspond, il est
  recherché directement par ID.

Si rien ne correspond, un message d'information est affiché et aucun compte n'est renvoyé.

```bash Exemples theme={null}
# By platform name (returns all matching accounts)
so-me accounts:get twitter

# By username / account name
so-me accounts:get @yourhandle

# By account ID
so-me accounts:get 550e8400-e29b-41d4-a716-446655440000
```

## accounts:get-details

Récupère tous les détails d'un compte social précis à partir de son UUID exact. Contrairement à
[`accounts:get`](#accountsget), cette commande n'accepte qu'un UUID et ne résout pas
par plateforme ou nom d'utilisateur.

```bash theme={null}
so-me accounts:get-details <id>
```

| Argument | Description |
| - | - |
| `<id>` | UUID du compte **(obligatoire)** |

```bash Exemple theme={null}
so-me accounts:get-details 550e8400-e29b-41d4-a716-446655440000
```

## accounts:connect

Connecte un nouveau compte social via OAuth dans le navigateur, avec un flux d'autorisation d'appareil.

```bash theme={null}
so-me accounts:connect --platform <platform>
```

| Option | Description |
| - | - |
| `--platform <platform>` | Plateforme à connecter : `twitter`, `x`, `linkedin`, `linkedin_page`, `instagram`, `facebook`, `tiktok`, `youtube`, `threads`, `pinterest`, `whatsapp`, `dribbble` **(obligatoire)** |

> [!NOTE]
>
> Vous devez être authentifié avant de connecter un compte. Exécutez d'abord `so-me auth:login` si
> la CLI signale que vous n'êtes pas authentifié.

Lorsque vous exécutez la commande, une URL de vérification et un code utilisateur s'affichent. La CLI tente
d'ouvrir automatiquement l'URL dans votre navigateur, puis interroge le serveur jusqu'à ce que le compte soit connecté
ou que le code d'appareil expire.

```bash Exemple theme={null}
so-me accounts:connect --platform instagram
```

```bash Sortie theme={null}
  To connect your account, open this URL in your browser:

  https://so-me.studio/cli/authorize

  And enter this code:

  ABCD-1234

  Code expires in 10 minutes.
  Browser opened automatically.
  Waiting for account connection...
  Account connected!

  Connected instagram account: @yourhandle
```

> [!WARNING]
>
> Si le code expire avant que vous ne terminiez le flux, la CLI se termine avec une erreur. Exécutez de nouveau
> `so-me accounts:connect` pour obtenir un nouveau code.

## accounts:remove

Supprime un compte social connecté à partir du nom de sa plateforme. Si plusieurs comptes existent pour la
plateforme, il vous est demandé d'en choisir un, puis de confirmer avant la suppression.

```bash theme={null}
so-me accounts:remove <platform>
```

| Argument | Description |
| - | - |
| `<platform>` | Nom de la plateforme : `twitter`, `x`, `linkedin`, `linkedin_page`, `instagram`, `facebook`, `tiktok`, `youtube`, `threads`, `pinterest`, `whatsapp`, `dribbble` **(obligatoire)** |

```bash Exemple theme={null}
so-me accounts:remove twitter
```

Si aucun compte n'existe pour la plateforme, un message d'information est affiché et rien n'est
supprimé. Pour contourner la recherche par plateforme et la sélection, utilisez
[`accounts:remove-by-id`](#accountsremove-by-id).

## accounts:remove-by-id

Supprime directement un compte social à partir de son UUID interne — utile lorsque vous avez plusieurs
comptes sur la même plateforme ou que vous voulez éviter la sélection interactive.

```bash theme={null}
so-me accounts:remove-by-id <id> [options]
```

| Argument | Description |
| - | - |
| `<id>` | UUID du compte **(obligatoire)** |

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

```bash Exemples theme={null}
# Confirm interactively
so-me accounts:remove-by-id 550e8400-e29b-41d4-a716-446655440000

# Skip confirmation
so-me accounts:remove-by-id 550e8400-e29b-41d4-a716-446655440000 -y
```


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