Switch conversation handler

Develop Env

http://localhost:3030

POST

/api/v1/accounts/{account_id}/conversations/{conversation_id}/handler_priority/switch

Switch the conversation handler between AI and workflow for pending conversations

Request

Authorization

API Key

Add parameter in header

api_access_token

Example:

api_access_token: ********************

Path Params

Body Params application/json; charset=utf-8Required

Examples

Responses

🟢200

application/json; charset=utf-8

Success - Handler switched successfully

Body

🟠400

🟠401

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://localhost:3030/api/v1/accounts//conversations//handler_priority/switch' \
--header 'api_access_token: <api-key>' \
--header 'Content-Type: application/json; charset=utf-8' \
--data-raw '{
    "handler_type": "ai"
}'

Response Example

200 - Example 1

{
    "success": true,
    "message": "Conversation switched to ai successfully",
    "conversation_id": 123,
    "status": "open",
    "handler_type": "ai"
}

Modified at 2025-12-16 21:29:06

Resolve conversation by session ID

Update Custom Attributes