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

> Biolink-Seiten mit Schaltflächen, Galerie, Designs und Analysen erstellen und verwalten

Biolinks sind öffentliche Link-in-Bio-Landingpages. Jede Seite hat einen eigenen Slug, einen Anzeigenamen und eine Bio, ein Design (Voreinstellung oder eigene Farben), eine Liste von Schaltflächen (Link, Social, E-Mail, Telefon, Datei, Text), ein Beitrags-/Galerieraster sowie Aufruf- und Klick-Analysen. Diese Seite dokumentiert jeden `biolink:`-Befehl der CLI.

> [!NOTE]
>
> Alle Befehle akzeptieren die [globalen Flags](/de/cli/overview.md#globale-optionen): `--json` (Standard) / `--table` für das Ausgabeformat, `--verbose` für detaillierte Fehler sowie `--api-key <key>` / `--api-url <url>`, um Zugangsdaten pro Aufruf zu überschreiben. Keiner der `biolink:`-Befehle akzeptiert Paginierungs-Flags.

## Kernbefehle

### biolink:list

Listet alle Biolink-Seiten der authentifizierten Organisation auf.

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

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

### biolink:get

Ruft alle Details eines einzelnen Biolinks über seine interne ID ab.

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

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

### biolink:public

Zeigt öffentliche Biolink-Daten über den eigenen Slug an. Dieser Befehl löst die Seite genauso auf wie ein Besucher, daher ist die interne UUID nicht nötig.

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

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

### biolink:create

Erstellt eine neue Biolink-Seite. Alle Optionen sind optional.

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

| Option | Beschreibung |
| - | - |
| `--slug <slug>` | Eigener URL-Slug (3–50 alphanumerische Zeichen) |
| `--name <name>` | Anzeigename |
| `--bio <bio>` | Bio-Text |

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

### biolink:update

Aktualisiert eine Biolink-Seite. Gib mindestens eine Option an, sonst beendet sich der Befehl mit einem Fehler.

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

| Option | Beschreibung |
| - | - |
| `--name <name>` | Anzeigename |
| `--bio <bio>` | Bio-Text |
| `--slug <slug>` | Eigener Slug |
| `--button-style <style>` | Schaltflächenstil: `rounded`, `square`, `pill`, `outline` |
| `--show-grid` | Instagram-Raster anzeigen |
| `--hide-grid` | Instagram-Raster ausblenden |
| `--social-icons <json>` | Social-Icons als JSON-Array von `{platform, url}`-Objekten |

> [!NOTE]
>
> `--social-icons` muss ein gültiges JSON-Array sein; bei ungültigem JSON beendet sich der Befehl mit einem Fehler, bevor eine Anfrage gestellt wird. `--show-grid` und `--hide-grid` legen die Sichtbarkeit des Instagram-Rasters fest (gib eines an, nicht beide).

```bash Beispiele theme={null}
# Umbenennen und die Bio neu schreiben
so-me biolink:update 550e8400-... --name "Acme Inc." --bio "Tools for makers"

# Schaltflächenstil wechseln und das Instagram-Raster anzeigen
so-me biolink:update 550e8400-... --button-style pill --show-grid

# Social-Icons setzen (JSON für deine Shell maskieren)
so-me biolink:update 550e8400-... \
  --social-icons '[{"platform":"instagram","url":"https://instagram.com/acme"},{"platform":"x","url":"https://x.com/acme"}]'
```

### biolink:delete

Löscht eine Biolink-Seite. Fragt nach einer Bestätigung, sofern nicht `-y/--yes` übergeben wird.

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

| Option | Beschreibung |
| - | - |
| `-y, --yes` | Bestätigungsabfrage überspringen |

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

### biolink:publish

Schaltet einen Biolink zwischen veröffentlicht und nicht veröffentlicht um. Der Befehl wechselt den jeweils aktuellen Zustand der Seite und meldet den neuen Status.

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

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

***

## Design

### biolink:theme

Ändert das Design eines Biolinks entweder über eine Voreinstellung **oder** eigene Farben. Gib `--preset` oder eine bzw. mehrere eigene Farboptionen an — fehlt beides, beendet sich der Befehl mit einem Fehler. Ist `--preset` angegeben, hat es Vorrang, und die eigenen Farboptionen werden ignoriert.

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

| Option | Beschreibung |
| - | - |
| `--preset <theme>` | Voreingestelltes Design: `default`, `dark`, `gradient`, `minimal`, `neon`, `sunset`, `ocean`, `forest` |
| `--bg <color>` | Eigene Hintergrundfarbe (Hex) |
| `--text <color>` | Eigene Textfarbe (Hex) |
| `--button <color>` | Eigene Schaltflächenfarbe (Hex) |
| `--button-text <color>` | Eigene Schaltflächentextfarbe (Hex) |

```bash Beispiele theme={null}
# Eine Voreinstellung verwenden
so-me biolink:theme 550e8400-... --preset neon

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

***

## Schaltflächen

> **biolink:buttons — Schaltflächen auflisten**
>
> Listet alle Schaltflächen eines Biolinks auf.
>
> ```bash theme={null}
> so-me biolink:buttons <biolink-id>
> ```
>
> ```bash Beispiel theme={null}
> so-me biolink:buttons 550e8400-... --table
> ```

> **biolink:add-button — Eine Schaltfläche hinzufügen**
>
> Fügt einem Biolink eine Schaltfläche hinzu. `--type` und `--text` sind erforderlich; die übrigen Optionen hängen vom Schaltflächentyp ab.
>
> ```bash theme={null}
> so-me biolink:add-button <biolink-id> --type <type> --text <text> [options]
> ```
>
> | Option | Beschreibung |
> | - | - |
> | `--type <type>` | Schaltflächentyp: `link`, `social`, `email`, `phone`, `file`, `text` **(erforderlich)** |
> | `--text <text>` | Schaltflächentext, max. 100 Zeichen **(erforderlich)** |
> | `--url <url>` | URL (für den Typ `link`/`social`) |
> | `--email <email>` | E-Mail-Adresse (für den Typ `email`) |
> | `--phone <phone>` | Telefonnummer (für den Typ `phone`) |
> | `--file-url <url>` | Datei-URL (für den Typ `file`) |
> | `--content <content>` | Inhalt (für den Typ `text`) |
> | `--icon <icon>` | Icon-Name |
> | `--color <hex>` | Eigene Schaltflächenfarbe (Hex) |
>
> ```bash Beispiele theme={null}
> # Link-Schaltfläche
> so-me biolink:add-button 550e8400-... --type link --text "Visit Website" --url https://example.com
>
> # Social-Schaltfläche mit Icon und eigener Farbe
> so-me biolink:add-button 550e8400-... --type social --text "Follow on X" \
>   --url https://x.com/acme --icon x --color "#000000"
>
> # E-Mail-Schaltfläche
> so-me biolink:add-button 550e8400-... --type email --text "Contact us" --email hello@example.com
> ```

> **biolink:update-button — Eine Schaltfläche aktualisieren**
>
> Aktualisiert eine bestehende Schaltfläche. Gib mindestens eine Option an, sonst beendet sich der Befehl mit einem Fehler.
>
> ```bash theme={null}
> so-me biolink:update-button <biolink-id> <button-id> [options]
> ```
>
> | Option | Beschreibung |
> | - | - |
> | `--text <text>` | Schaltflächentext |
> | `--url <url>` | URL |
> | `--icon <icon>` | Icon |
> | `--color <hex>` | Eigene Farbe |
> | `--active` | Auf aktiv setzen |
> | `--inactive` | Auf inaktiv setzen |
>
> ```bash Beispiel theme={null}
> so-me biolink:update-button 550e8400-... btn-123 --text "Shop now" --url https://example.com/shop --active
> ```

> **biolink:delete-button — Eine Schaltfläche löschen**
>
> Löscht eine Schaltfläche. Fragt nach einer Bestätigung, sofern nicht `-y/--yes` übergeben wird.
>
> ```bash theme={null}
> so-me biolink:delete-button <biolink-id> <button-id> [options]
> ```
>
> | Option | Beschreibung |
> | - | - |
> | `-y, --yes` | Bestätigungsabfrage überspringen |
>
> ```bash Beispiel theme={null}
> so-me biolink:delete-button 550e8400-... btn-123 --yes
> ```

> **biolink:reorder-buttons — Schaltflächen neu anordnen**
>
> Ordnet die Schaltflächen eines Biolinks neu an. Übergib die Schaltflächen-IDs als Positionsargumente in der gewünschten Anzeigereihenfolge.
>
> ```bash theme={null}
> so-me biolink:reorder-buttons <biolink-id> <button-ids...>
> ```
>
> ```bash Beispiel theme={null}
> so-me biolink:reorder-buttons 550e8400-... btn-3 btn-1 btn-2
> ```

***

## Galerie

> **biolink:posts — Galeriebeiträge auflisten**
>
> Listet die Beiträge/Galerieeinträge eines Biolinks auf.
>
> ```bash theme={null}
> so-me biolink:posts <biolink-id>
> ```
>
> ```bash Beispiel theme={null}
> so-me biolink:posts 550e8400-... --table
> ```

> **biolink:add-post — Einen Galeriebeitrag hinzufügen**
>
> Fügt der Galerie einen Beitrag hinzu. Alle Optionen sind optional.
>
> ```bash theme={null}
> so-me biolink:add-post <biolink-id> [options]
> ```
>
> | Option | Beschreibung |
> | - | - |
> | `--image <url>` | Bild-URL |
> | `--caption <text>` | Bildunterschrift |
> | `--link <url>` | Link-URL |
>
> ```bash Beispiel 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 — Einen Galeriebeitrag aktualisieren**
>
> Aktualisiert einen Galeriebeitrag. Gib mindestens eine Option an, sonst beendet sich der Befehl mit einem Fehler.
>
> ```bash theme={null}
> so-me biolink:update-post <biolink-id> <post-id> [options]
> ```
>
> | Option | Beschreibung |
> | - | - |
> | `--caption <text>` | Bildunterschrift |
> | `--link <url>` | Link-URL |
> | `--visible` | Auf sichtbar setzen |
> | `--hidden` | Auf ausgeblendet setzen |
>
> ```bash Beispiel theme={null}
> so-me biolink:update-post 550e8400-... post-123 --caption "Updated caption" --hidden
> ```

> **biolink:delete-post — Einen Galeriebeitrag löschen**
>
> Löscht einen Galeriebeitrag. Fragt nach einer Bestätigung, sofern nicht `-y/--yes` übergeben wird.
>
> ```bash theme={null}
> so-me biolink:delete-post <biolink-id> <post-id> [options]
> ```
>
> | Option | Beschreibung |
> | - | - |
> | `-y, --yes` | Bestätigungsabfrage überspringen |
>
> ```bash Beispiel theme={null}
> so-me biolink:delete-post 550e8400-... post-123 --yes
> ```

> **biolink:reorder-posts — Galeriebeiträge neu anordnen**
>
> Ordnet Galeriebeiträge neu an. Übergib die Beitrags-IDs als Positionsargumente in der gewünschten Anzeigereihenfolge.
>
> ```bash theme={null}
> so-me biolink:reorder-posts <biolink-id> <post-ids...>
> ```
>
> ```bash Beispiel theme={null}
> so-me biolink:reorder-posts 550e8400-... post-3 post-1 post-2
> ```

***

## Analysen

### biolink:analytics

Ruft Analysen für einen Biolink ab, einschließlich Aufrufen, Klicks und Klickrate (CTR).

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

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


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