AgentBots
Inbox API
Conversations API
Contact Labels
CSAT Survey Page
Account AgentBots
Agents
Canned Responses
Canned Response
Custom Attributes
Contacts
Automation Rule
Help Center
Conversations
Conversation Assignment
Conversation Labels
Inboxes
Integrations
Profile
Teams
Custom Filters
Conversation Assignment
Assign Conversation
Conversation Assignment
Assign Conversation
Assign a conversation to an agent or a team
POST
/
api
/
v1
/
accounts
/
{account_id}
/
conversations
/
{conversation_id}
/
assignments
curl --request POST \
--url https://app.chatwoot.com/api/v1/accounts/{account_id}/conversations/{conversation_id}/assignments \
--header 'Content-Type: application/json' \
--header 'api_access_token: <api-key>' \
--data '{
"assignee_id": 123,
"team_id": 123
}'
{
"id": 123,
"uid": "<string>",
"name": "<string>",
"available_name": "<string>",
"display_name": "<string>",
"email": "<string>",
"account_id": 123,
"role": "agent",
"confirmed": true,
"custom_attributes": {},
"accounts": [
{
"id": 123,
"name": "<string>",
"role": "administrator"
}
]
}
Authorizations
This token can be obtained by visiting the profile page or via rails console. Provides access to endpoints based on the user permissions levels. This token can be saved by an external system when user is created via API, to perform activities on behalf of the user.
Path Parameters
The numeric ID of the account
The numeric ID of the conversation
Body
application/json
Response
200
application/json
Success
The response is of type object
.
curl --request POST \
--url https://app.chatwoot.com/api/v1/accounts/{account_id}/conversations/{conversation_id}/assignments \
--header 'Content-Type: application/json' \
--header 'api_access_token: <api-key>' \
--data '{
"assignee_id": 123,
"team_id": 123
}'
{
"id": 123,
"uid": "<string>",
"name": "<string>",
"available_name": "<string>",
"display_name": "<string>",
"email": "<string>",
"account_id": 123,
"role": "agent",
"confirmed": true,
"custom_attributes": {},
"accounts": [
{
"id": 123,
"name": "<string>",
"role": "administrator"
}
]
}