Assign conversation

Assign a conversation to one or more teammates.

POST https://cotlet.dev/api/v1/podium/conversations/{conversation_id}/assign

write

Sets the assignee of a conversation, as the + Assign icon does in the Inbox. Pass one name, or several to assign more than one teammate. The names are the ones the assign dropdown lists for your account. It reaches no customer and one more call changes the assignment again, so it does not wait for your OK.

Parameters

Parameters: assign_conversation
NameTypeDescription
conversation_id string required string Conversation ID from list_conversations.
users array required array Teammate names as the assign dropdown shows them, for example ['Dana Reyes'].

Request

cURL
curl -X POST https://cotlet.dev/api/v1/podium/conversations/conv_91d3/assign \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"users":["Sam Ortiz"]}'
Python
result = client.call("podium", "assign_conversation", {"conversation_id":"conv_91d3","users":["Sam Ortiz"]})
Node.js
const result = await cotlet.call('podium', 'assign_conversation', {"conversation_id":"conv_91d3","users":["Sam Ortiz"]});
CLI
cotlet call podium assign_conversation --data '{"conversation_id":"conv_91d3","users":["Sam Ortiz"]}'

Example response

JSON

{
  "conversation_id": "conv_91d3",
  "assigned_to": [
    "Dana Reyes"
  ],
  "status": "assigned"
}

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.