Ferndesk

Unterhaltung aktualisieren

Weist die Unterhaltung als Teammitglied des API-Schlüssels zu oder hebt die Zuweisung auf, fügt Labels hinzu oder entfernt sie, öffnet oder schließt sie, stellt sie zurück oder legt ihre Priorität fest. Senden Sie nur die zu ändernden Felder; Felder, die bereits den gewünschten Wert haben, bleiben unverändert. Die Änderungen werden in der aufgeführten Reihenfolge angewendet. Wird eine Änderung abgelehnt, wurden die vorherigen bereits angewendet. Bei einem korrigierten erneuten Versuch mit derselben client_request_id werden diese wiederholt und die übrigen angewendet. Erfordert die Rolle Owner oder Admin.

PATCH /v1/conversations/{id}
Bearer-Token Scope inbox:write

Pfadparameter

· 1
id string erforderlich

Body

erforderlich application/json
assignee_id string | null

Eine Teammitglied-ID (mem_...), der die Unterhaltung zugewiesen werden soll, oder null, um die Zuweisung aufzuheben.

add_labels array of string · max items: 20

Label-IDs (tag_...), die hinzugefügt werden sollen.

remove_labels array of string · max items: 20

Label-IDs (tag_...), die entfernt werden sollen.

status string · Enum

open öffnet die Unterhaltung erneut; closed markiert sie als erledigt.

Werte

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

Stellt die Unterhaltung bis zu diesem Zeitpunkt zurück; dann wird sie wieder geöffnet. Nicht zusammen mit status verwenden.

priority string · Enum

Werte

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

Eine ID Ihrer Wahl für diese Anfrage. Eine erneute Anfrage mit derselben ID wiederholt die erste Anfrage, statt die Aktion zweimal auszuführen; eine andere Anfrage mit derselben ID gilt als neue Anfrage.

Antworten