Assign conversation
Assign a conversation to a teammate, a team or nobody.
POST https://cotlet.dev/api/v1/help-scout/conversations/{conversation_id}/assign
write
Sets the Assignee of the conversation, as the Assignee field in the Details card does. Assign to a user by name or email; a team needs the Plus or Pro plan; pass unassigned to clear it. Light Users cannot be assigned conversations, and the call returns that error instead of changing anything. Assignment reaches no customer and one call undoes it, so it does not ask for your OK.
Parameters
| Name | Type | Description |
|---|---|---|
| conversation_id integer required | integer | Conversation number from search_conversations. |
| assignee string required | string | User name or email, a team name (Plus or Pro plan), or 'unassigned'. |
Request
curl -X POST https://cotlet.dev/api/v1/help-scout/conversations/1/assign \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"assignee":"assignee"}'result = client.call("help-scout", "assign_conversation", {"conversation_id":1,"assignee":"assignee"})const result = await cotlet.call('help-scout', 'assign_conversation', {"conversation_id":1,"assignee":"assignee"});cotlet call help-scout assign_conversation --data '{"conversation_id":1,"assignee":"assignee"}'Example response
{
"conversation_id": 48244,
"assignee": "Maria Silva",
"previous_assignee": null,
"folder": "Assigned"
}