This API is used to edit existing phone number details in CloudAgent. The user has to update the ‘action’ parameter with the 'edit' function. For example, if the action parameter = edit along with the following parameters, this API edits the edits phone number.
To use this API with the help of a token, follow these steps:
- Generate the Token: Use the 'Generate Token' API to obtain an authentication token.
- Enter the Token ID: Navigate to the right section of this page, under the 'AUTHORIZATION' tab. Here, input the generated token ID.
- With the token entered, pass the below header and body parameters:
Header parameters
| Parameter | Description |
|---|---|
| Content-Type | application/json |
Body Params
{
"userName":"xxxx",
"action":"edit",
"phoneNumber":"xxxxx",
"phoneName":"xxxx",
"phoneNumberNew":"xxxx",
"phoneNameNew":"xxxx"
"unAssignSkill":"kolm,lok,Python",
"assignSkill":"General,QA_Skill,kolm,lok,Python"}
| Parameter | Description |
|---|---|
| userName* | CloudAgent user name |
| action* | "edit" |
| phoneNumber* | Existing phone number that is to be edited |
| phoneName* | Existing phone name which is to be edited |
| phoneNumberNew* | New number to be updated |
| PhoneNameNew | New name to be updated |
| unAssignSkill | To un assign skills while editing the phone Number |
| assignSkill | To assign skills while editing the phone Number |
Note
- Parameters with ‘*’ are considered to be mandatory parameters.
- phoneNumber with special characters(+1, +91 etc.,) are to be encoded(add %2B instead of ‘+’) while passing in the request.
- The ‘phoneName’ parameter is not case-sensitive.
Possible responses
Success response | "status": "success" |
Invalid api_key | "status": "error" |
Invalid action | "status": "error" |
Invalid phoneNumber | "status": "error" |
Invalid username | "status": "error" |
Empty phoneName | "status": "error" |
Empty phoneNumber | "status": "error" |
Number/Name exists | "status": "error" |
If the phone number creation limit exceeded | "status": "error" |
Invalid Skill Key | "status": "success" |
Missing Skill Value | "status": "success" |