Ferndesk

Update a conversation

Assigns or unassigns the conversation, adds or removes labels, opens or closes it, snoozes it or sets its priority, as the key's teammate. Send only the fields to change; one already as asked is left alone. They apply in the order listed, so when one is refused the ones before it have applied, and a corrected retry with the same client_request_id repeats those and applies the rest. Needs an owner or admin.

PATCH /v1/conversations/{id}
Bearer token scope inbox:write

Path parameters

· 1
id string required

Body

required application/json
assignee_id string | null

A teammate id (mem_...) to assign, or null to unassign.

add_labels array of string · max items: 20

Label ids (tag_...) to add.

remove_labels array of string · max items: 20

Label ids (tag_...) to remove.

status string · enum

open reopens the conversation; closed marks it done.

values

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

Snooze it until this time; it comes back open then. Not with status.

priority string · enum

values

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

Any id you choose for this request. The same id with the same request again repeats the first instead of doing it twice; a different request under the same id is a new one.

Responses