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

# Biolinks

> Créez et gérez des pages biolink avec boutons, galerie, thèmes et analyses

Les biolinks sont des pages d'atterrissage publiques de type « lien dans la bio ». Chaque page a un slug personnalisé, un nom d'affichage et une bio,
un thème (prédéfini ou couleurs personnalisées), une liste de boutons (liens, réseaux sociaux, e-mail, téléphone, fichier, texte), une
grille de publications/galerie et des analyses de vues et de clics. Cette page documente chaque commande `biolink:` exposée par
la CLI.

> [!NOTE]
>
> Toutes les commandes acceptent les [options globales](/fr/cli/overview.md#options-globales) : `--json` (par défaut) / `--table`
> pour le format de sortie, `--verbose` pour des erreurs détaillées, et `--api-key <key>` / `--api-url <url>` pour
> remplacer les identifiants à chaque appel. Aucune commande `biolink:` n'accepte d'options de pagination.

## Base

### biolink:list

Liste toutes les pages biolink de l'organisation authentifiée.

```bash theme={null}
so-me biolink:list
```

```bash Exemple theme={null}
so-me biolink:list --table
```

### biolink:get

Récupère tous les détails d'un biolink à partir de son ID interne.

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

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

### biolink:public

Affiche les données publiques d'un biolink à partir de son slug personnalisé. Cette commande résout la page comme le ferait un
visiteur, elle n'exige donc pas l'UUID interne.

```bash theme={null}
so-me biolink:public <slug>
```

```bash Exemple theme={null}
so-me biolink:public my-brand-page
```

### biolink:create

Crée une nouvelle page biolink. Toutes les options sont facultatives.

```bash theme={null}
so-me biolink:create [options]
```

| Option | Description |
| - | - |
| `--slug <slug>` | Slug d'URL personnalisé (3 à 50 caractères alphanumériques) |
| `--name <name>` | Nom d'affichage |
| `--bio <bio>` | Texte de la bio |

```bash Exemple theme={null}
so-me biolink:create --slug mypage --name "My Brand" --bio "Welcome to my page"
```

### biolink:update

Met à jour une page biolink. Fournissez au moins une option, sinon la commande se termine avec une erreur.

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

| Option | Description |
| - | - |
| `--name <name>` | Nom d'affichage |
| `--bio <bio>` | Texte de la bio |
| `--slug <slug>` | Slug personnalisé |
| `--button-style <style>` | Style des boutons : `rounded`, `square`, `pill`, `outline` |
| `--show-grid` | Affiche la grille Instagram |
| `--hide-grid` | Masque la grille Instagram |
| `--social-icons <json>` | Icônes de réseaux sociaux sous forme de tableau JSON d'objets `{platform, url}` |

> [!NOTE]
>
> `--social-icons` doit être un tableau JSON valide ; un JSON invalide met fin à la commande avec une erreur avant l'envoi de toute
> requête. `--show-grid` et `--hide-grid` définissent la visibilité de la grille Instagram (passez l'une des deux, pas les deux).

```bash Exemples theme={null}
# Rename and rewrite the bio
so-me biolink:update 550e8400-... --name "Acme Inc." --bio "Tools for makers"

# Switch button style and show the Instagram grid
so-me biolink:update 550e8400-... --button-style pill --show-grid

# Set social icons (escape the JSON for your shell)
so-me biolink:update 550e8400-... \
  --social-icons '[{"platform":"instagram","url":"https://instagram.com/acme"},{"platform":"x","url":"https://x.com/acme"}]'
```

### biolink:delete

Supprime une page biolink. Une confirmation est demandée, sauf si `-y/--yes` est passé.

```bash theme={null}
so-me biolink:delete <id> [options]
```

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

```bash Exemple theme={null}
so-me biolink:delete 550e8400-... --yes
```

### biolink:publish

Bascule un biolink entre publié et non publié. La commande inverse l'état actuel de la page
et indique le nouveau statut.

```bash theme={null}
so-me biolink:publish <id>
```

```bash Exemple theme={null}
so-me biolink:publish 550e8400-...
```

***

## Thème

### biolink:theme

Modifie le thème d'un biolink à l'aide d'un thème prédéfini **ou** de couleurs personnalisées. Fournissez `--preset`, ou une
ou plusieurs options de couleur personnalisée — n'en fournir aucune met fin à la commande avec une erreur. Si `--preset` est indiqué, il a
priorité et les options de couleur personnalisée sont ignorées.

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

| Option | Description |
| - | - |
| `--preset <theme>` | Thème prédéfini : `default`, `dark`, `gradient`, `minimal`, `neon`, `sunset`, `ocean`, `forest` |
| `--bg <color>` | Couleur d'arrière-plan personnalisée (hexadécimal) |
| `--text <color>` | Couleur de texte personnalisée (hexadécimal) |
| `--button <color>` | Couleur de bouton personnalisée (hexadécimal) |
| `--button-text <color>` | Couleur du texte des boutons personnalisée (hexadécimal) |

```bash Exemples theme={null}
# Use a preset
so-me biolink:theme 550e8400-... --preset neon

# Custom colors
so-me biolink:theme 550e8400-... --bg "#1a1a2e" --text "#eaeaea" --button "#5417d7" --button-text "#ffffff"
```

***

## Boutons

> **biolink:buttons — Lister les boutons**
>
> Liste tous les boutons d'un biolink.
>
> ```bash theme={null}
> so-me biolink:buttons <biolink-id>
> ```
>
> ```bash Exemple theme={null}
> so-me biolink:buttons 550e8400-... --table
> ```

> **biolink:add-button — Ajouter un bouton**
>
> Ajoute un bouton à un biolink. `--type` et `--text` sont obligatoires ; les autres options dépendent du
> type de bouton.
>
> ```bash theme={null}
> so-me biolink:add-button <biolink-id> --type <type> --text <text> [options]
> ```
>
> | Option | Description |
> | - | - |
> | `--type <type>` | Type de bouton : `link`, `social`, `email`, `phone`, `file`, `text` **(obligatoire)** |
> | `--text <text>` | Texte du bouton, 100 caractères max. **(obligatoire)** |
> | `--url <url>` | URL (pour le type `link`/`social`) |
> | `--email <email>` | E-mail (pour le type `email`) |
> | `--phone <phone>` | Téléphone (pour le type `phone`) |
> | `--file-url <url>` | URL du fichier (pour le type `file`) |
> | `--content <content>` | Contenu (pour le type `text`) |
> | `--icon <icon>` | Nom de l'icône |
> | `--color <hex>` | Couleur de bouton personnalisée (hexadécimal) |
>
> ```bash Exemples theme={null}
> # Link button
> so-me biolink:add-button 550e8400-... --type link --text "Visit Website" --url https://example.com
>
> # Social button with an icon and custom color
> so-me biolink:add-button 550e8400-... --type social --text "Follow on X" \
>   --url https://x.com/acme --icon x --color "#000000"
>
> # Email button
> so-me biolink:add-button 550e8400-... --type email --text "Contact us" --email hello@example.com
> ```

> **biolink:update-button — Modifier un bouton**
>
> Met à jour un bouton existant. Fournissez au moins une option, sinon la commande se termine avec une erreur.
>
> ```bash theme={null}
> so-me biolink:update-button <biolink-id> <button-id> [options]
> ```
>
> | Option | Description |
> | - | - |
> | `--text <text>` | Texte du bouton |
> | `--url <url>` | URL |
> | `--icon <icon>` | Icône |
> | `--color <hex>` | Couleur personnalisée |
> | `--active` | Définit comme actif |
> | `--inactive` | Définit comme inactif |
>
> ```bash Exemple theme={null}
> so-me biolink:update-button 550e8400-... btn-123 --text "Shop now" --url https://example.com/shop --active
> ```

> **biolink:delete-button — Supprimer un bouton**
>
> Supprime un bouton. Une confirmation est demandée, sauf si `-y/--yes` est passé.
>
> ```bash theme={null}
> so-me biolink:delete-button <biolink-id> <button-id> [options]
> ```
>
> | Option | Description |
> | - | - |
> | `-y, --yes` | Ignore la demande de confirmation |
>
> ```bash Exemple theme={null}
> so-me biolink:delete-button 550e8400-... btn-123 --yes
> ```

> **biolink:reorder-buttons — Réorganiser les boutons**
>
> Réorganise les boutons d'un biolink. Passez les ID des boutons en arguments positionnels dans l'ordre d'affichage
> souhaité.
>
> ```bash theme={null}
> so-me biolink:reorder-buttons <biolink-id> <button-ids...>
> ```
>
> ```bash Exemple theme={null}
> so-me biolink:reorder-buttons 550e8400-... btn-3 btn-1 btn-2
> ```

***

## Galerie

> **biolink:posts — Lister les publications de la galerie**
>
> Liste les publications/éléments de la galerie d'un biolink.
>
> ```bash theme={null}
> so-me biolink:posts <biolink-id>
> ```
>
> ```bash Exemple theme={null}
> so-me biolink:posts 550e8400-... --table
> ```

> **biolink:add-post — Ajouter une publication à la galerie**
>
> Ajoute une publication à la galerie. Toutes les options sont facultatives.
>
> ```bash theme={null}
> so-me biolink:add-post <biolink-id> [options]
> ```
>
> | Option | Description |
> | - | - |
> | `--image <url>` | URL de l'image |
> | `--caption <text>` | Légende |
> | `--link <url>` | URL du lien |
>
> ```bash Exemple theme={null}
> so-me biolink:add-post 550e8400-... \
>   --image https://cdn.example.com/photo.jpg \
>   --caption "Behind the scenes" \
>   --link https://example.com/blog
> ```

> **biolink:update-post — Modifier une publication de la galerie**
>
> Met à jour une publication de la galerie. Fournissez au moins une option, sinon la commande se termine avec une erreur.
>
> ```bash theme={null}
> so-me biolink:update-post <biolink-id> <post-id> [options]
> ```
>
> | Option | Description |
> | - | - |
> | `--caption <text>` | Légende |
> | `--link <url>` | URL du lien |
> | `--visible` | Définit comme visible |
> | `--hidden` | Définit comme masqué |
>
> ```bash Exemple theme={null}
> so-me biolink:update-post 550e8400-... post-123 --caption "Updated caption" --hidden
> ```

> **biolink:delete-post — Supprimer une publication de la galerie**
>
> Supprime une publication de la galerie. Une confirmation est demandée, sauf si `-y/--yes` est passé.
>
> ```bash theme={null}
> so-me biolink:delete-post <biolink-id> <post-id> [options]
> ```
>
> | Option | Description |
> | - | - |
> | `-y, --yes` | Ignore la demande de confirmation |
>
> ```bash Exemple theme={null}
> so-me biolink:delete-post 550e8400-... post-123 --yes
> ```

> **biolink:reorder-posts — Réorganiser les publications de la galerie**
>
> Réorganise les publications de la galerie. Passez les ID des publications en arguments positionnels dans l'ordre d'affichage souhaité.
>
> ```bash theme={null}
> so-me biolink:reorder-posts <biolink-id> <post-ids...>
> ```
>
> ```bash Exemple theme={null}
> so-me biolink:reorder-posts 550e8400-... post-3 post-1 post-2
> ```

***

## Analyses

### biolink:analytics

Récupère les analyses d'un biolink, y compris les vues, les clics et le taux de clics (CTR).

```bash theme={null}
so-me biolink:analytics <id>
```

```bash Exemple theme={null}
so-me biolink:analytics 550e8400-... --table
```


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