Assign conversation
Assign a conversation to a teammate, or leave user_id out to unassign it.
POST https://cotlet.dev/api/v1/freescout/conversations/{conversation_id}/assign
write Confirm
Sets the assignee of one conversation. user_id must be a person returned by list_users for that mailbox. The teammate gets an email about it if their Notifications are set up for that. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| conversation_id integer required | integer | Conversation ID from list_conversations or get_conversation. It is not the #number shown in the list. |
| user_id integer | integer | User ID from list_users. Leave out to unassign. |
Request
curl -X POST https://cotlet.dev/api/v1/freescout/conversations/4850/assign \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"user_id":3}' result = client.call("freescout", "assign_conversation", {"conversation_id":4850,"user_id":3}) const result = await cotlet.call('freescout', 'assign_conversation', {"conversation_id":4850,"user_id":3}); cotlet call freescout assign_conversation --data '{"conversation_id":4850,"user_id":3}' Example response
{
"conversation_id": 4850,
"assignee": {
"user_id": 3,
"name": "Sam Okafor"
},
"status": "active"
}