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

Parameters: assign_conversation
NameTypeDescription
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
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}'
Python
result = client.call("freescout", "assign_conversation", {"conversation_id":4850,"user_id":3})
Node.js
const result = await cotlet.call('freescout', 'assign_conversation', {"conversation_id":4850,"user_id":3});
CLI
cotlet call freescout assign_conversation --data '{"conversation_id":4850,"user_id":3}'

Example response

JSON

{
  "conversation_id": 4850,
  "assignee": {
    "user_id": 3,
    "name": "Sam Okafor"
  },
  "status": "active"
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.