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

# Entwürfe

> Entwürfe verwalten und in geplante Beiträge umwandeln

Mit den Entwurfsbefehlen speicherst du Beiträge in Arbeit, verfeinerst sie nach und nach und wandelst sie in geplante Beiträge um, sobald du bereit zur Veröffentlichung bist.

> [!NOTE]
>
> Alle Befehle akzeptieren die globalen Flags `--json` (Standard), `--table`, `--verbose`, `--api-key <key>` und `--api-url <url>`. Du kannst dich auch über die Umgebungsvariablen `SOME_API_KEY` und `SOME_API_URL` authentifizieren.

## drafts:list

Listet Entwürfe in deinem Workspace auf.

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

| Option | Beschreibung |
| - | - |
| `--page <number>` | Seitennummer (Standard: `1`) |
| `--limit <number>` | Einträge pro Seite (Standard: `20`) |

```bash Beispiele theme={null}
# Erste Seite als Tabelle
so-me drafts:list --table

# Zweite Seite, 50 pro Seite
so-me drafts:list --page 2 --limit 50
```

## drafts:get

Ruft einen einzelnen Entwurf über seine ID ab.

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

| Argument | Beschreibung |
| - | - |
| `<id>` | Entwurfs-ID |

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

## drafts:create

Erstellt einen neuen Entwurf.

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

| Option | Beschreibung |
| - | - |
| `-c, --content <text>` | Entwurfsinhalt |
| `--title <title>` | Entwurfstitel |
| `--platform <platform>` | Social-Plattform: `TWITTER`, `LINKEDIN`, `INSTAGRAM` usw. |
| `--post-type <type>` | Inhaltstyp: `TEXT`, `IMAGE`, `VIDEO` usw. |
| `--description <desc>` | Entwurfsbeschreibung |
| `-a, --account <id>` | ID des Social-Kontos |
| `-m, --media <urls...>` | Medien-URLs (aus `media:upload` oder vom CDN) |
| `--metadata <json>` | Metadaten als JSON |

> [!NOTE]
>
> Der Wert von `--platform` wird vor dem Senden automatisch in Großbuchstaben umgewandelt. Über `-m, --media` übergebene Medien-URLs werden zusammen mit allen in `--metadata` angegebenen Schlüsseln in die Metadaten des Entwurfs übernommen.

```bash Beispiele theme={null}
# Einfacher Textentwurf
so-me drafts:create -c "Draft idea" --post-type TEXT

# Entwurf für eine bestimmte Plattform
so-me drafts:create -c "LinkedIn idea" --platform LINKEDIN --post-type TEXT

# Entwurf mit einer einzelnen Medien-URL
so-me drafts:create -c "With image" --post-type IMAGE -m https://cdn.example.com/photo.jpg

# Entwurf mit mehreren Medien-URLs
so-me drafts:create -c "Multiple media" -m url1 url2 url3 --post-type MULTIPLE_IMAGES

# Entwurf mit eigenen Metadaten
so-me drafts:create -c "With metadata" --metadata '{"key":"value"}'
```

## drafts:update

Aktualisiert einen bestehenden Entwurf.

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

| Argument | Beschreibung |
| - | - |
| `<id>` | Entwurfs-ID |

| Option | Beschreibung |
| - | - |
| `-c, --content <text>` | Aktualisierter Inhalt |
| `--title <title>` | Aktualisierter Titel |
| `--platform <platform>` | Social-Plattform: `TWITTER`, `LINKEDIN`, `INSTAGRAM` usw. |
| `--post-type <type>` | Aktualisierter Inhaltstyp |
| `--description <desc>` | Aktualisierte Beschreibung |
| `-m, --media <urls...>` | Medien-URLs (ersetzt die vorhandenen) |
| `--metadata <json>` | Aktualisierte Metadaten als JSON |

```bash Beispiel theme={null}
so-me drafts:update 550e8400-... -c "Revised draft copy" --title "Launch teaser"
```

## drafts:delete

Löscht einen oder mehrere Entwürfe. Du wirst um Bestätigung gebeten, sofern du nicht `-y, --yes` angibst. Die CLI löscht die übrigen IDs weiter, auch wenn eine davon fehlschlägt.

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

| Argument | Beschreibung |
| - | - |
| `<ids...>` | Eine oder mehrere Entwurfs-IDs |

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

```bash Beispiele theme={null}
# Einen einzelnen Entwurf löschen (fragt nach Bestätigung)
so-me drafts:delete draft-id-1

# Mehrere Entwürfe ohne Bestätigung löschen
so-me drafts:delete draft-id-1 draft-id-2 -y
```

## drafts:convert

Wandelt einen Entwurf in einen Beitrag um. Alle Optionen, die du angibst, überschreiben die im Entwurf gespeicherten Werte.

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

| Argument | Beschreibung |
| - | - |
| `<id>` | Entwurfs-ID |

| Option | Beschreibung |
| - | - |
| `--platform <platform>` | Social-Plattform: `TWITTER`, `LINKEDIN`, `INSTAGRAM` usw. |
| `--post-type <type>` | Inhaltstyp: `TEXT`, `IMAGE`, `VIDEO` usw. |
| `-c, --content <text>` | Beitragsinhalt (überschreibt den Entwurfstext) |
| `-a, --account <id>` | ID des Social-Kontos |
| `-s, --date <date>` | Planungsdatum (ISO 8601) |

```bash Beispiele theme={null}
# In einen Twitter-Beitrag umwandeln
so-me drafts:convert <id> --platform TWITTER --post-type TEXT

# Umwandeln und für LinkedIn planen
so-me drafts:convert <id> --platform LINKEDIN -s 2026-04-10T14:00:00Z

# In einen Instagram-Bildbeitrag umwandeln
so-me drafts:convert <id> --platform INSTAGRAM --post-type IMAGE
```

> [!TIP]
>
> Wenn du `--platform` angibst, aber `--account` weglässt, sucht die CLI deine verbundenen Konten für diese Plattform. Passt genau eines, wird es automatisch ausgewählt; passen mehrere, wirst du aufgefordert, interaktiv eines zu wählen. Wird kein Konto gefunden, läuft die Umwandlung ohne bestimmtes Konto weiter, und das Backend entscheidet über die weitere Behandlung.


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