Zur Navigation springen

Agent-Konversationsticket aktualisieren

Aktualisiert Titel, Kommentar, Status, Priorität und/oder Bearbeiter eines Tickets. Erfordert Editor-Zugriff auf den Agenten des Tickets.

Pfadparameter

agentqa_ticket_idstringErforderlich

Header

xi-api-keystringOptional

Anfrage

This endpoint expects an object.
titlestring or nullOptional1-120 characters

Aktualisiert, falls angegeben, den Ticket-Titel. Lassen Sie den Parameter weg, um ihn unverändert zu lassen.

statusenum or nullOptional

Falls angegeben, wird der Ticketstatus aktualisiert. Weglassen, um ihn unverändert zu lassen.

Erlaubte Werte:
assignee_user_idstring or nullOptional

Falls angegeben, wird aktualisiert, wer für die Lösung dieses Tickets verantwortlich ist. Muss ein Workspace-Mitglied mit mindestens Viewer-Zugriff auf den Agenten sein. Übergeben Sie null, um die Zuweisung aufzuheben. Weglassen, um die Angabe unverändert zu lassen.

priorityenum or nullOptional

Aktualisiert, falls angegeben, wie dringend das Ticket bearbeitet werden muss. Übergeben Sie null, um den Wert zu löschen. Lassen Sie den Parameter weg, um ihn unverändert zu lassen.

Erlaubte Werte:

Antwort

Erfolgreiche Antwort
agentqa_ticket_idstring
workspace_idstring
owner_user_idstring
agent_idstring
needs_clusteringboolean
titlestring or null

Einzeilige Überschrift für das Ticket. None nur bei Tickets, die erstellt wurden, bevor Titel verfügbar waren.

issue_typeenum or null
labelslist of strings
conversation_idslist of strings
first_seen_unix_secsinteger or null
last_seen_unix_secsinteger or null
qa_commentstring or null
ticket_commentslist of objects
turn_commentslist of objects
statusenum
Erlaubte Werte:
priorityenum or null
Erlaubte Werte:
priority_changeslist of objects
status_changeslist of objects
sourceenum
Erlaubte Werte:
assignee_user_idstring or null
created_at_unix_secsinteger
updated_at_unix_secsinteger
merged_into_ticket_idstring or nullOptional

Das Ticket, in das dieses Ticket zusammengeführt wurde. Wird gesetzt, solange sein Status ‘merged’ ist.

search_matchobject or nullOptional

Wo die search-Abfrage der Liste übereinstimmte. Wird nur bei durchsuchten Listen gesetzt.

Fehler

422
Unprocessable Entity Error