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

# Brouillons

> Gérez les brouillons de publications et convertissez-les en publications programmées

Les commandes de brouillons vous permettent d'enregistrer des publications en cours de rédaction, de les affiner au fil du temps et de les convertir
en publications programmées lorsque vous êtes prêt à publier.

> [!NOTE]
>
> Toutes les commandes acceptent les options globales `--json` (par défaut), `--table`, `--verbose`,
> `--api-key <key>` et `--api-url <url>`. Vous pouvez aussi vous authentifier avec les variables d'environnement `SOME_API_KEY`
> et `SOME_API_URL`.

## drafts:list

Liste les brouillons de votre espace de travail.

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

| Option | Description |
| - | - |
| `--page <number>` | Numéro de page (par défaut : `1`) |
| `--limit <number>` | Éléments par page (par défaut : `20`) |

```bash Exemples theme={null}
# First page as a table
so-me drafts:list --table

# Second page, 50 per page
so-me drafts:list --page 2 --limit 50
```

## drafts:get

Récupère un brouillon par son ID.

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

| Argument | Description |
| - | - |
| `<id>` | ID du brouillon |

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

## drafts:create

Crée un nouveau brouillon.

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

| Option | Description |
| - | - |
| `-c, --content <text>` | Contenu du brouillon |
| `--title <title>` | Titre du brouillon |
| `--platform <platform>` | Plateforme sociale : `TWITTER`, `LINKEDIN`, `INSTAGRAM`, etc. |
| `--post-type <type>` | Type de contenu : `TEXT`, `IMAGE`, `VIDEO`, etc. |
| `--description <desc>` | Description du brouillon |
| `-a, --account <id>` | ID du compte social |
| `-m, --media <urls...>` | URL de médias (issues de `media:upload` ou du CDN) |
| `--metadata <json>` | Métadonnées au format JSON |

> [!NOTE]
>
> La valeur de `--platform` est automatiquement mise en majuscules avant l'envoi. Les URL de médias transmises via
> `-m, --media` sont fusionnées dans les métadonnées du brouillon, avec les clés éventuellement fournies dans `--metadata`.

```bash Exemples theme={null}
# Simple text draft
so-me drafts:create -c "Draft idea" --post-type TEXT

# Draft targeting a specific platform
so-me drafts:create -c "LinkedIn idea" --platform LINKEDIN --post-type TEXT

# Draft with a single media URL
so-me drafts:create -c "With image" --post-type IMAGE -m https://cdn.example.com/photo.jpg

# Draft with multiple media URLs
so-me drafts:create -c "Multiple media" -m url1 url2 url3 --post-type MULTIPLE_IMAGES

# Draft with custom metadata
so-me drafts:create -c "With metadata" --metadata '{"key":"value"}'
```

## drafts:update

Met à jour un brouillon existant.

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

| Argument | Description |
| - | - |
| `<id>` | ID du brouillon |

| Option | Description |
| - | - |
| `-c, --content <text>` | Contenu mis à jour |
| `--title <title>` | Titre mis à jour |
| `--platform <platform>` | Plateforme sociale : `TWITTER`, `LINKEDIN`, `INSTAGRAM`, etc. |
| `--post-type <type>` | Type de contenu mis à jour |
| `--description <desc>` | Description mise à jour |
| `-m, --media <urls...>` | URL de médias (remplace les existantes) |
| `--metadata <json>` | Métadonnées mises à jour au format JSON |

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

## drafts:delete

Supprime un ou plusieurs brouillons. Une confirmation vous est demandée, sauf si vous passez `-y, --yes`.
La CLI continue de supprimer les ID restants même si l'un d'eux échoue.

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

| Argument | Description |
| - | - |
| `<ids...>` | Un ou plusieurs ID de brouillons |

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

```bash Exemples theme={null}
# Delete a single draft (prompts for confirmation)
so-me drafts:delete draft-id-1

# Bulk delete several drafts without confirmation
so-me drafts:delete draft-id-1 draft-id-2 -y
```

## drafts:convert

Convertit un brouillon en publication. Les options que vous transmettez remplacent les valeurs enregistrées sur le brouillon.

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

| Argument | Description |
| - | - |
| `<id>` | ID du brouillon |

| Option | Description |
| - | - |
| `--platform <platform>` | Plateforme sociale : `TWITTER`, `LINKEDIN`, `INSTAGRAM`, etc. |
| `--post-type <type>` | Type de contenu : `TEXT`, `IMAGE`, `VIDEO`, etc. |
| `-c, --content <text>` | Contenu de la publication (remplace le texte du brouillon) |
| `-a, --account <id>` | ID du compte social |
| `-s, --date <date>` | Date de programmation (ISO 8601) |

```bash Exemples theme={null}
# Convert to a Twitter post
so-me drafts:convert <id> --platform TWITTER --post-type TEXT

# Convert and schedule for LinkedIn
so-me drafts:convert <id> --platform LINKEDIN -s 2026-04-10T14:00:00Z

# Convert to an Instagram image post
so-me drafts:convert <id> --platform INSTAGRAM --post-type IMAGE
```

> [!TIP]
>
> Lorsque vous passez `--platform` sans `--account`, la CLI recherche vos comptes connectés pour
> cette plateforme. Si un seul correspond, il est sélectionné automatiquement ; si plusieurs correspondent, il vous est
> demandé d'en choisir un de façon interactive. Si aucun compte n'est trouvé, la conversion se poursuit sans
> compte précis et le backend décide comment la traiter.


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