Transferring a conversation to A Skill REST API

Method

Method URL
PUT https://{domain}/v1/transferToSkill/account/{accountId}/conversation/{conversationId}?skillId={skillId}

Headers

Name Value Example
Authorization Bearer 9014c8e3e4a3f8022f544774e8f43deccd9ecf30509cc1825

Path Params

Name Value Example
accountId 63358097
conversationId 3ba8451d-2722-4181-b4db-532c76b8f037

Query Params

Name Required
skillId Yes

Response Codes

Code Response
202 Accepted — Will be executed Asynchronously
400 Bad request — Problem with query parameters
401 Unauthorized — Bad Authentication
403 Forbidden — Bad Authorization (invalid permissions)
429 Rate Limit - Too many requests
500 Internal Server Error — Please try again after the time specified in the response has passed

Response Body For 400/401/403/429/500

This is an example response body for errors :

   {
    "exceptionType": "MissingServletRequestParameterException",
    "message": "Required Long parameter 'agentId' is not present"
   }