# Créer un fil de discussion

> Démarre un fil de discussion sur un élément de conversation. content devient le premier commentaire du fil, et la réponse est le fil complet incluant ce…

`POST /v2/api/threads`

<Note>
**Scope requis :** `THREADS_WRITE`
</Note>

## Comportement

Démarre un fil de discussion sur un élément de conversation. `content` devient le premier commentaire du fil, et la réponse est le fil complet incluant ce commentaire.

Chaque élément ne peut avoir **qu'un seul fil**. S'il en existe déjà un, la requête retourne une erreur `409` avec le code `THREAD_ALREADY_EXISTS` — retrouvez-le avec [`GET /v2/api/threads`](/fr/docs/threads/find-thread) et ajoutez-y un commentaire à la place.

## Mentions

Mentionnez des coéquipiers inline dans `content` avec `@[Display Name](usr-xxxx)` — voir le [guide des mentions](/fr/docs/notes/overview#mentions).

## Erreurs

| Statut | Code | Quand |
|--------|------|-------|
| `400` | `INVALID_THREAD_ENTITY_TYPE` | `entity_type` n'est pas l'un de `CALL`, `TEXT_MESSAGE`, `CONVERSATION_NOTE` |
| `400` | `EMPTY_NOTE_CONTENT` | `content` est manquant ou vide |
| `400` | `NOTE_CONTENT_TOO_LONG` | `content` dépasse 4 000 caractères |
| `404` | `CONVERSATION_ITEM_NOT_FOUND` | Aucun élément de conversation avec cet `entity_id` |
| `409` | `THREAD_ALREADY_EXISTS` | L'élément a déjà un fil |
