# Modifier une boîte de réception

> Modifie seulement les champs envoyés et retourne la boîte. Envoyer sources remplace toute la liste. Envoyer filters remplace les filtres enregistrés, et…

`PATCH /v2/api/inboxes/{inbox_id}`

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

## Comportement

Modifie seulement les champs envoyés et retourne la boîte. Envoyer `sources` remplace toute la liste. Envoyer `filters` remplace les filtres enregistrés, et `"filters": null` les efface. Les réglages À traiter et Les miennes de la boîte dans l'app sont conservés dans les deux cas. Envoyer `"emoji": ""` efface l'emoji. Un emoji absent ou `null` le conserve.

Pour couper les notifications d'une boîte, envoyez `{"notifications_muted": true}`. Pour les réactiver, envoyez `false`.

Pour mettre une boîte en favori, envoyez `{"favorite": true}`. Les boîtes favorites s'affichent en premier dans le sélecteur de boîtes de l'app, de la plus ancienne à la plus récente, et la réponse contient `favorited_at`. Remettre en favori une boîte qui l'est déjà conserve son premier `favorited_at`. Pour la retirer des favoris, envoyez `false` : `favorited_at` repasse à `null`.

Envoyez `user_id` dans le corps JSON pour modifier la boîte d'un coéquipier. Seuls les admins et managers de l'espace de travail du coéquipier peuvent le faire. Une boîte sans source dans un espace de travail que l'appelant gère retourne une erreur `404`. Envoyer `sources` remplace seulement les lignes des espaces de l'appelant : les lignes du coéquipier dans d'autres espaces sont conservées.

## Erreurs

| Statut | Code | Quand |
|--------|------|-------|
| `400` | `INBOX_NAME_REQUIRED` | `name` est envoyé vide |
| `400` | `INVALID_INBOX_SOURCE` | Une source, une condition ou une touche est nulle ou invalide, un chemin de menu n'est pas dans les [options de menu](/fr/docs/inboxes/list-menu-options) de cette ligne, deux sources ont le même `allo_number`, ou une boîte de coéquipier n'aurait plus aucune ligne dans l'espace de travail de l'appelant |
| `400` | `INVALID_REQUEST_BODY` | `name` dépasse 80 caractères, `emoji` dépasse 16, plus de 100 sources, ou plus de 10 conditions dans une source. `field_errors` nomme chaque champ |
| `400` | `INVALID_INBOX_FILTERS` | `filters` contient une clé inconnue ou une valeur invalide |
| `403` | `FORBIDDEN` | `user_id` est renseigné et l'appelant n'est ni admin ni manager de l'espace de travail de ce coéquipier |
| `403` | `ALLO_NUMBER_FORBIDDEN` | Une ligne source n'est pas accessible au propriétaire de la boîte, ou, avec `user_id`, n'est pas dans un espace de travail que l'appelant gère |
| `404` | `INBOX_NOT_FOUND` | Aucune boîte avec cet ID n'appartient au propriétaire, ou, avec `user_id`, elle n'a aucune source dans un espace de travail que l'appelant gère |
