Ferndesk

Mettre à jour une conversation

Attribue ou désattribue la conversation, ajoute ou supprime des libellés, l’ouvre ou la ferme, la met en veille ou définit sa priorité, en tant que membre de l’équipe associé à la clé. Envoyez uniquement les champs à modifier ; toute valeur déjà conforme à la demande reste inchangée. Les modifications sont appliquées dans l’ordre indiqué : si l’une d’elles est refusée, celles qui la précèdent ont été appliquées. Une nouvelle tentative corrigée avec le même client_request_id répète ces modifications et applique les autres. Nécessite le rôle de propriétaire ou d’administrateur.

PATCH /v1/conversations/{id}
Jeton Bearer portée inbox:write

Paramètres de chemin

· 1
id string requis

Corps

requis application/json
assignee_id string | null

Un identifiant de membre de l’équipe (mem_...) à attribuer, ou null pour désattribuer.

add_labels array of string · max items: 20

Identifiants de libellés (tag_...) à ajouter.

remove_labels array of string · max items: 20

Identifiants de libellés (tag_...) à supprimer.

status string · énumération

open rouvre la conversation ; closed la marque comme terminée.

valeurs

  • open
  • closed
snooze_until string · date-time · motif

Met la conversation en veille jusqu’à cette heure ; elle est rouverte à ce moment-là. À ne pas utiliser avec status.

priority string · énumération

valeurs

  • urgent
  • high
  • normal
  • low
client_request_id string · min length: 1· max length: 200

Un identifiant de votre choix pour cette requête. Réutiliser le même identifiant avec la même requête répète la première requête au lieu de l’exécuter deux fois ; une requête différente utilisant le même identifiant est considérée comme une nouvelle requête.

Réponses