Skip to content
Navigation
POST/conversations/{conversationId}/priority

Set a conversation priority

Set the triage priority on a conversation.

Parameters

NameInTypeDescription
conversationIdrequiredpathstringConversation ID

Request body

FieldTypeDescription
priorityrequired"none" | "low" | "medium" | "high" | "urgent"

Response

Updated conversation

FieldTypeDescription
idrequiredstringTypeID - a type-prefixed UUID
statusrequired"open" | "snoozed" | "closed"Current conversation status
channelrequired"messenger" | "email" | "github"Channel the conversation arrived on
priorityrequired"none" | "low" | "medium" | "high" | "urgent"Agent-set triage priority
subjectrequiredstringnullConversation subject line, null for messenger threads
visitorPrincipalIdrequiredstringPrincipal ID of the visiting user
visitorEmailrequiredstringnullCaptured contact email for the visitor, null if not provided
assignedAgentPrincipalIdrequiredstring | nullPrincipal ID of the assigned agent, null if unassigned
lastMessageAtrequiredstringISO 8601 timestamp
resolvedAtrequiredstring | nullWhen the conversation was resolved, null while still active
createdAtrequiredstringISO 8601 timestamp

Errors

400Validation error
401Unauthorized
404Conversation not found

Example request

curl \
  -X POST \
  "https://feedback.quackback.io/api/v1/conversations/:conversationId/priority" \
  -H "Authorization: Bearer qb_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
  "priority": "high"
}'