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

# Beiträge

> Social-Media-Beiträge in der CLI erstellen, planen und verwalten

Mit der Befehlsgruppe `posts` listest du Beiträge auf allen verbundenen Plattformen auf, erstellst, aktualisierst, planst, wiederholst und löschst sie. Alle Befehle akzeptieren die globalen Flags (`--json` als Standard, `--table`, `--verbose`, `--api-key`, `--api-url`) und lesen die Zugangsdaten aus `SOME_API_KEY` / `SOME_API_URL`, wenn diese Flags fehlen.

## posts:list

Listet Beiträge in deinem Workspace mit optionaler Filterung auf. Um stattdessen nach einem Datumsbereich zu filtern, verwende [`posts:calendar`](#postscalendar).

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

| Option | Beschreibung | Standard |
| - | - | - |
| `--status <status>` | Nach Status filtern: `SCHEDULED`, `POSTED`, `FAILED`, `PENDING`, `PENDING_APPROVAL`, `REJECTED`, `DRAFT` | – |
| `--platform <platform>` | Nach Plattform filtern (z. B. `TWITTER`, `LINKEDIN`) | – |
| `--page <number>` | Seitennummer | `1` |
| `--limit <number>` | Einträge pro Seite (max. `100`) | `20` |

```bash Beispiel theme={null}
so-me posts:list --status SCHEDULED --platform TWITTER --table
```

## posts:get

Ruft einen einzelnen Beitrag mit allen Details über seine ID ab.

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

| Argument | Beschreibung |
| - | - |
| `<id>` | Beitrags-ID **(erforderlich)** |

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

## posts:calendar

Ruft geplante Beiträge innerhalb eines bestimmten Datumsbereichs ab. Nützlich für kalenderartige Ansichten.

```bash theme={null}
so-me posts:calendar --start <iso-date> --end <iso-date>
```

| Option | Beschreibung |
| - | - |
| `--start <date>` | Startdatum (ISO 8601) **(erforderlich)** |
| `--end <date>` | Enddatum (ISO 8601) **(erforderlich)** |

```bash Beispiel theme={null}
so-me posts:calendar --start 2026-04-01T00:00:00Z --end 2026-04-30T23:59:59Z
```

## posts:create

Erstellt einen neuen Beitrag für eine beliebige verbundene Plattform. Lass `--date` weg, um sofort zu veröffentlichen, oder gib einen ISO-8601-Zeitstempel an, um für später zu planen.

```bash theme={null}
so-me posts:create -c <text> [options]
```

| Option | Beschreibung | Standard |
| - | - | - |
| `-c, --content <text>` | Beitragsinhalt **(erforderlich)** | – |
| `-s, --date <date>` | Geplantes Datum (ISO 8601). Weglassen, um sofort zu veröffentlichen | – |
| `-t, --type <type>` | Beitragsart: `schedule` oder `draft` | `schedule` |
| `-m, --media <items>` | Kommagetrennte lokale Dateipfade und/oder Medien-Datei-IDs | – |
| `-a, --accounts <ids>` | Konto-ID, von der aus gepostet wird | – |
| `--post-type <type>` | Inhaltstyp: `TEXT`, `IMAGE`, `VIDEO`, `CAROUSEL`, `REEL`, `STORY` | `TEXT` |
| `--platform <platform>` | Social-Plattform: `TWITTER`, `LINKEDIN` usw. | `TWITTER` |
| `--metadata <json>` | Plattformspezifische Metadaten als JSON | – |
| `-j, --json-file <path>` | Pfad zu einer JSON-Datei, die einen komplexen Beitrag beschreibt | – |

```bash Beispiele theme={null}
# Einfacher Textbeitrag (wird sofort veröffentlicht)
so-me posts:create -c "Hello world!" --platform TWITTER

# Geplanter LinkedIn-Beitrag
so-me posts:create -c "Scheduled post" -s 2026-04-10T14:00:00Z --platform LINKEDIN

# Beitrag mit einer lokalen Bilddatei
so-me posts:create -c "With media" -m ./photo.jpg --post-type IMAGE

# Beitrag mit vorhandenen Datei-IDs aus der Medienbibliothek
so-me posts:create -c "By file id" -m file-id-1,file-id-2 --post-type IMAGE

# Als Entwurf speichern, statt zu planen
so-me posts:create -c "Work in progress" -t draft --platform TWITTER

# Komplexer Beitrag aus einer JSON-Datei
so-me posts:create -j ./campaign.json
```

> [!NOTE]
>
> Die Option `-m, --media` akzeptiert eine kommagetrennte Mischung aus **lokalen Dateipfaden** und **vorhandenen Medien-Datei-UUIDs**. Lokale Dateien werden automatisch vorsigniert und hochgeladen; UUIDs werden aus deiner Medienbibliothek geladen. Jeder Eintrag muss entweder ein lesbarer Dateipfad oder eine gültige Datei-UUID sein — alles andere wird abgelehnt. Unterstützte Dateitypen sind unter anderem PNG, JPG, JPEG, GIF, WebP, SVG, MP4, MOV, AVI, WebM, MP3, WAV und PDF.

> [!TIP]
>
> Wenn du `--accounts` nicht angibst und mehrere Konten für die gewählte Plattform hast, fordert dich die CLI auf, interaktiv eines auszuwählen. Beim Erstellen eines Entwurfs (`-t draft`) ist das Konto optional — der Beitrag wird ohne Konto eingereicht, wenn keines angegeben oder aufgelöst wird.

> [!WARNING]
>
> Wird `-j, --json-file` angegeben, wird der Dateiinhalt unverändert als Request-Body verwendet, und die übrigen Flags (`-c`, `--platform`, `--media` usw.) werden ignoriert.

## posts:update

Aktualisiert Text, geplantes Datum oder plattformspezifische Metadaten eines bestehenden Beitrags.

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

| Argument | Beschreibung |
| - | - |
| `<id>` | Beitrags-ID **(erforderlich)** |

| Option | Beschreibung |
| - | - |
| `-c, --content <text>` | Aktualisierter Inhalt |
| `-s, --date <date>` | Aktualisiertes geplantes Datum (ISO 8601) |
| `--metadata <json>` | Aktualisierte plattformspezifische Metadaten als JSON |

```bash Beispiel theme={null}
so-me posts:update 550e8400-e29b-41d4-a716-446655440000 -c "Updated content" -s 2026-04-16T10:00:00Z
```

## posts:delete

Löscht einen oder mehrere Beiträge. Bei einer einzelnen ID wird der Endpunkt zum Einzellöschen aufgerufen; bei mehreren IDs wird das Massenlöschen verwendet. Fragt nach einer Bestätigung, sofern `-y` nicht gesetzt ist.

```bash theme={null}
so-me posts:delete <ids...> [options]
```

| Argument | Beschreibung |
| - | - |
| `<ids...>` | Eine oder mehrere Beitrags-IDs **(erforderlich)** |

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

```bash Beispiele theme={null}
# Einen einzelnen Beitrag löschen
so-me posts:delete 550e8400-e29b-41d4-a716-446655440000

# Mehrere Beiträge löschen und die Bestätigung überspringen
so-me posts:delete id-1 id-2 id-3 -y
```

## posts:bulk-delete

Löscht mehrere Beiträge per ID in einer einzigen Massenanfrage. Fragt nach einer Bestätigung, sofern `-y` nicht gesetzt ist.

```bash theme={null}
so-me posts:bulk-delete <ids...> [options]
```

| Argument | Beschreibung |
| - | - |
| `<ids...>` | Zu löschende Beitrags-IDs **(erforderlich)** |

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

```bash Beispiel theme={null}
so-me posts:bulk-delete id-1 id-2 id-3 -y
```

## posts:schedule

Plant einen Beitrag für ein zukünftiges Datum.

```bash theme={null}
so-me posts:schedule <id> -s <date>
```

| Argument | Beschreibung |
| - | - |
| `<id>` | Beitrags-ID **(erforderlich)** |

| Option | Beschreibung |
| - | - |
| `-s, --date <date>` | Planungsdatum (ISO 8601, muss in der Zukunft liegen) **(erforderlich)** |

```bash Beispiel theme={null}
so-me posts:schedule 550e8400-e29b-41d4-a716-446655440000 -s 2026-04-15T14:00:00Z
```

## posts:unschedule

Entfernt einen Beitrag aus dem Zeitplan.

```bash theme={null}
so-me posts:unschedule <id>
```

| Argument | Beschreibung |
| - | - |
| `<id>` | Beitrags-ID **(erforderlich)** |

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

## posts:retry

Wiederholt einen fehlgeschlagenen Beitrag. Der Beitrag wird erneut zur Veröffentlichung in die Warteschlange gestellt.

```bash theme={null}
so-me posts:retry <id>
```

| Argument | Beschreibung |
| - | - |
| `<id>` | Beitrags-ID **(erforderlich)** |

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

## posts:resubmit

Reicht einen abgelehnten Beitrag erneut zur Freigabe ein.

```bash theme={null}
so-me posts:resubmit <id>
```

| Argument | Beschreibung |
| - | - |
| `<id>` | Beitrags-ID **(erforderlich)** |

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


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