Change the tag of a conversation

Sets the workflow tag shown in the Customerly inbox. This is not a contact tag: to tag contacts use
POST /tags.

  • A change_tag message is added to the conversation, as when changing the tag from the Customerly inbox
  • Setting the tag the conversation already has changes nothing
  • none removes the tag

Request Fields

Required fields

  • tag (string): The new tag. One of none, in_progress, waiting, priority.

Examples

Mark a conversation as waiting

{ "tag": "waiting" }
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required
\d+

The conversation id

Body Params
string
enum
required

The new conversation tag (none removes it)

Allowed:
Responses

401

Authentication required

403

Permission denied or conversation access denied

404

Conversation not found

409

Conversation is frozen

422

Validation failed

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json