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

# Commentaires

> Gérez les commentaires de publication depuis la CLI

Les commentaires de publication sont le fil d'échanges et de notes propre à chaque publication Social media studio. Ces commandes vous permettent de les lister, ajouter, modifier, supprimer et marquer comme lus.

> [!NOTE]
>
> Toutes les commandes acceptent les [options globales](/fr/cli/overview.md#options-globales) : `--json` (par défaut) / `--table`, `--verbose`, `--api-key <key>` et `--api-url <url>`. Vous pouvez aussi définir `SOME_API_KEY` et `SOME_API_URL` dans votre environnement.

## comments:list

Liste les commentaires d'une publication.

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

**post-id** `string` *required*

UUID de la publication dont vous souhaitez lister les commentaires.

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

```bash Exemples theme={null}
# Default JSON output
so-me comments:list 550e8400-e29b-41d4-a716-446655440000

# Table view
so-me comments:list 550e8400-... --table

# Paginate
so-me comments:list 550e8400-... --page 2 --limit 50

# Only unread comments via jq
so-me comments:list 550e8400-... | jq '.[] | select(.isRead == false)'
```

## comments:add

Ajoute un commentaire à une publication.

```bash theme={null}
so-me comments:add <post-id> --content <text>
```

**post-id** `string` *required*

UUID de la publication à commenter.

| Option | Description |
| - | - |
| `--content <text>` | Texte du commentaire **(obligatoire)** |

```bash Exemples theme={null}
# Short comment
so-me comments:add 550e8400-... --content "Great post!"

# Comment with emoji
so-me comments:add 550e8400-... --content "Ship it 🚀"

# Multi-line comment via shell quoting
so-me comments:add 550e8400-... --content "Line one
Line two"
```

## comments:update

Met à jour un commentaire existant.

```bash theme={null}
so-me comments:update <comment-id> --content <text>
```

**comment-id** `string` *required*

UUID du commentaire à modifier.

| Option | Description |
| - | - |
| `--content <text>` | Nouveau texte du commentaire **(obligatoire)** |

```bash Exemple theme={null}
so-me comments:update 7c2d4e8f-... --content "Edited: updated thoughts"
```

## comments:delete

Supprime un commentaire.

```bash theme={null}
so-me comments:delete <comment-id>
```

**comment-id** `string` *required*

UUID du commentaire à supprimer.

```bash Exemples theme={null}
# Delete a single comment
so-me comments:delete 7c2d4e8f-...

# Delete all comments on a post in one pipeline
so-me comments:list 550e8400-... --limit 100 \
  | jq -r '.[].id' \
  | xargs -I {} so-me comments:delete {}
```

## comments:mark-read

Marque tous les commentaires d'une publication comme lus — efface le badge « non lu » de votre espace de travail.

```bash theme={null}
so-me comments:mark-read <post-id>
```

**post-id** `string` *required*

UUID de la publication dont les commentaires doivent être marqués comme lus.

```bash Exemples theme={null}
# Mark a single post's comments as read
so-me comments:mark-read 550e8400-e29b-41d4-a716-446655440000

# Mark all scheduled posts' comments as read
so-me posts:list --status SCHEDULED \
  | jq -r '.[].id' \
  | xargs -I {} so-me comments:mark-read {}
```


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