Update Agent Rating

PUT

/v2/api/agent/{agent_id}/rating

Overview

This endpoint allows you to update the rating for a specific agent by changing the type of vote (either upvote or downvote). If a user has previously rated the agent, this endpoint provides the functionality to modify their vote.

Functionality

Update Vote Type: You can modify an existing rating for a specific agent by choosing either an upvote or a downvote.

Agent Identification: The agent to be rated is identified by a unique agent_id.

Vote Type: You can select whether the rating should be an upvote or a downvote. The new vote type will replace the existing one.

How to Find Your Agent ID

If you're unsure about the agent_id, follow this guide:
How to View Agent ID

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request PUT 'https:///v2/api/agent/0/rating' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "vote_type": "upvote"
}'

Response Example

200 - Example 1

{
    "success": true,
    "message": "Agent Rating updated successfully",
    "data": [
        {
            "id": 77,
            "created_by": "user@example.com",
            "created_on": "2025-01-16T21:23:41.587726Z",
            "modified_by": "",
            "modified_on": "2025-01-16T21:23:41.587749Z",
            "is_upvote": false,
            "user": 160,
            "agent": 1251
        }
    ]
}

Request

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Agent rating updated successfully.

Body

🟠400Bad Request

🟠404Record Not Found

🔴500Server Error

Get Agent Rating

Get All Agent Aliases

Update Agent Rating

Overview#

Functionality#

How to Find Your Agent ID#

Request

Responses

Overview

Functionality

How to Find Your Agent ID