POST/conversations/{conversationId}/assign

Assign a conversation

Assign to a teammate, or pass null to unassign.

Parameters

Name	In	Type	Description
`conversationId`required	path	`string`	Conversation ID

Request body

Field	Type	Description
`assigneePrincipalId`	`stringnull`	Agent principal id; null or omitted unassigns

Response

Updated conversation

Field	Type	Description
`id`required	`string`	TypeID - a type-prefixed UUID
`status`required	`"open" \| "snoozed" \| "closed"`	Current conversation status
`channel`required	`"messenger" \| "email" \| "github"`	Channel the conversation arrived on
`priority`required	`"none" \| "low" \| "medium" \| "high" \| "urgent"`	Agent-set triage priority
`subject`required	`stringnull`	Conversation subject line, null for messenger threads
`visitorPrincipalId`required	`string`	Principal ID of the visiting user
`visitorEmail`required	`stringnull`	Captured contact email for the visitor, null if not provided
`assignedAgentPrincipalId`required	`string \| null`	Principal ID of the assigned agent, null if unassigned
`lastMessageAt`required	`string`	ISO 8601 timestamp
`resolvedAt`required	`string \| null`	When the conversation was resolved, null while still active
`createdAt`required	`string`	ISO 8601 timestamp

Errors

400Validation error

401Unauthorized

404Conversation not found

Example request

curl \
  -X POST \
  "https://feedback.quackback.io/api/v1/conversations/:conversationId/assign" \
  -H "Authorization: Bearer qb_your_api_key_here" \
  -H "Content-Type: application/json"