Ferndesk

Actualizar una conversación

Asigna o desasigna la conversación, agrega o quita etiquetas, la abre o la cierra, la pospone o establece su prioridad, como compañero de equipo asociado a la clave. Envía solo los campos que quieras cambiar; si un campo ya tiene el valor solicitado, no se modifica. Se aplican en el orden indicado, así que si se rechaza uno, los anteriores ya se habrán aplicado; al reintentar con una corrección y el mismo client_request_id, se repiten esos cambios y se aplican los restantes. Se requiere un propietario o administrador.

PATCH /v1/conversations/{id}
Token Bearer ámbito inbox:write

Parámetros de ruta

· 1
id string obligatorio

Cuerpo

obligatorio application/json
assignee_id string | null

Un id de compañero de equipo (mem_...) para asignar, o null para desasignar.

add_labels array of string · max items: 20

Ids de etiquetas (tag_...) que se agregarán.

remove_labels array of string · max items: 20

Ids de etiquetas (tag_...) que se quitarán.

status string · enumeración

open vuelve a abrir la conversación; closed la marca como finalizada.

valores

  • open
  • closed
snooze_until string · date-time · patrón

Pospón la conversación hasta esta hora; entonces volverá a estar abierta. No se puede usar con status.

priority string · enumeración

valores

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

Cualquier id que elijas para esta solicitud. Si vuelves a enviar la misma solicitud con el mismo id, se repite la primera en lugar de ejecutarla dos veces; una solicitud diferente con el mismo id se considera nueva.

Respuestas