Assign, reassign, or clear the conversation assignee
userId is the id from GET /api/v1/inbox/channels/{channelId}/assignees. That person must already be able to open this channel. null clears the assignee. Setting the same assignee does nothing and writes no system message. A real change writes one SYSTEM message.
bearerAuthorizationBearer <token>Key issued in Settings → Developer → API key. Inbox methods need the Inbox scope. Campaigns methods need the Campaigns scope.
conversationId*stringConversation id
application/json- body
userId*|User id from GET /api/v1/inbox/channels/{channelId}/assignees. Null clears the assignee. The same assignee is a no-op.
Updated conversation row.
application/json- response
id*stringchannelId*stringChannel id, for example QAF261225002
contactId*stringstatus*stringThe key sets only OPEN or CLOSED. Other values can appear on older rows.
"OPEN""CLOSED""ASSIGNED""RESOLVED""BLOCKED"assignedTo?|User id of the assignee. Null when unassigned.
assignedUser?|nulllastMessageAt?|date-timeisUnread*booleantags*array<string>lastMessagePreview?string|nulllastMessageType?string|nulllastMessageDirection?|"INBOUND""OUTBOUND"lastMessageStatus?string|nullunreadCount*numberisBlocked*booleantitle?|Custom title. Null until renamed.
lastCustomerMessageAt?|Last inbound customer message. Used for the WhatsApp service window.
date-timecreatedAt*stringdate-timeupdatedAt*stringdate-timecontact?|Present on GET conversation, list, and search. Absent on block, title, and status writes.
channelType?stringPresent on reads.
customerPhone?|Customer phone taken from the contact.
curl -X PATCH 'https://api.1msg.io/api/v1/inbox/conversations/string/assignee' \ -H 'Content-Type: application/json' \ -d '{ "userId": "66c21609-01ed-4f83-8058-9b6ac090db3f"}'{ "id": "string", "channelId": "string", "contactId": "string", "status": "OPEN", "assignedTo": "string", "assignedUser": { "id": "b2bb82f0-2253-4e05-b955-a21f3d699caa", "name": "QA Stage", "avatar": null }, "lastMessageAt": "2019-08-24T14:15:22Z", "isUnread": true, "tags": [ "string" ], "lastMessagePreview": "string", "lastMessageType": "string", "lastMessageDirection": "INBOUND", "lastMessageStatus": "string", "unreadCount": 0, "isBlocked": true, "title": "string", "lastCustomerMessageAt": "2019-08-24T14:15:22Z", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "contact": { "id": "string", "phoneNumber": "79001234567", "name": "string", "avatar": "string" }, "channelType": "WABA", "customerPhone": "string"}