Passer au contenu principal
PATCH
Update inbox
Scope requis : INBOXES_WRITE

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

Autorisations

Authorization
string
header
requis

Paramètres de chemin

inbox_id
string
requis

Inbox ID (inb-*).

Exemple:

"inb-abc123"

Corps

application/json
name
string

Cannot be blank.

Maximum string length: 80
Exemple:

"Sales"

emoji
string | null

"" clears the emoji. Absent or null keeps it.

Maximum string length: 16
Exemple:

"💼"

sources
object[]

Replaces the whole list. With user_id, only the lines in the caller's workspaces are replaced.

Maximum array length: 100
filters
object | null

Replaces the saved filters. null clears them, absent keeps them. The app's Needs action and Mine settings are kept either way.

notifications_muted
boolean
Exemple:

false

user_id
string

Update this teammate's inbox (usr-*). The caller must be an admin or manager of that teammate's workspace.

Exemple:

"usr-abc123"

Réponse

Inbox updated

data
object