Allo

Supprimer une boîte de réception

Supprime la boîte de réception et retourne un 204 sans corps. Les conversations qu'elle affichait ne sont pas touchées et restent sur leurs lignes.

DELETE/v2/api/inboxes/{inbox_id}

Comportement

Supprime la boîte de réception et retourne un 204 sans corps. Les conversations qu'elle affichait ne sont pas touchées et restent sur leurs lignes.

Passez le paramètre de requête user_id pour supprimer 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. Une boîte qui contient aussi des lignes d'un autre espace retourne une erreur 403 : seul le coéquipier peut la supprimer.

Erreurs

StatutCodeQuand
403FORBIDDENuser_id est renseigné et l'appelant n'est ni admin ni manager de l'espace de travail de ce coéquipier, ou la boîte contient aussi des lignes d'un autre espace de travail
404INBOX_NOT_FOUNDAucune 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

Autorisation

Authorizationstring · headerrequis

Api-Key ak_live_…

Paramètres de chemin

inbox_idstringrequis

Inbox ID (inb-*).

Paramètres de requête

user_idstring

Act on a teammate's inbox (usr-*). The caller must be an admin or manager of that teammate's workspace, and only reaches inboxes and sources in workspaces they manage. Omit to act on your own inboxes.

Réponses

204Inbox deleted
401
403
404
429