API Reference
Start typing to search…

Edit Agent Details (Token Authentication)

put https://{domainname}/ca_apis/updateAgent

Updates the details of an existing agent, such as name, skills, groups, and other attributes.

This API allows you to update/edit the details of an existing agent in your CloudAgent account.

To use this API with the help of a token, follow these steps:

  1. Generate the Token: Use the 'Generate Token' API to obtain an authentication token.
  2. Enter the Token ID: Navigate to the right section of this page, under the 'AUTHORIZATION' tab. Here, input the generated token ID.
  3. With the token entered, pass the below header and body parameters:

❗️

Rate Limit:

This API permits up to 5 requests per minute.

Possible Responses

Missing apiKey key / Missing apiKey Value

"{""status"": ""false"",""message"": ""Api Key Should Not be Null or Empty."",
""data"": null}"

Passing Invalid apiKey Value

{"status": "false","message": "Invalid User Details","data": null}

Passing Invalid userName Value / Missing userName key / Missing userName Value

{"status": "false","message": "Invalid User Details","data": null}

Passing Invalid agentId Value / Missing agentId key / Missing agentId Value /

"{
""status"": ""error"",
""message"": ""Agent not found""
}"

Passing Invalid agentName Value

"{""Status"": ""Fail"",""Message"": {
""agentName"": ""The agent name must not be empty and it should be between 2 and 50 alphanumeric characters and allow special characters such as., @, _, -""}}"

Missing agentName Value

"{""status"": ""error"",
""message"": ""Agent Name is required""}"

Passing Invalid password Value

{"message": "Password length must be between 3 and 50 characters","status": "error"}

Missing password Value

"{""message"": ""Password is required"",
""status"": ""error""}"

Passing Invalid email Value

"{""message"": ""Invalid email format"",
""status"": ""error""}"

Missing email key

{"message": "Email should not be null or empty","status": "error"}

Missing email Value

{"message": "Email should not be null or empty","status": "error"}

Verify rate limit of updation API.

"{""status"": ""error"",
""message"": ""Max limit exceeded""}"

Language
Credentials
Bearer
URL
Click Try It! to start a request and see the response here!