To retrieve the details of a particular agent with the given stream Id and agent Id.
Method | GET |
Endpoint | https://{{host}}/agentassist/api/v1/public/{{streamId}}/agents/{{agentId}} |
Content-Type | application/json |
Authorization | auth: {{JWT}} See How to generate the JWT Token. |
API Scope | SmartAssist Analytics |
Path Parameters
Parameter | Description | Type |
---|---|---|
host | Environment URL, for example, https://smartassist.kore.ai | string, required |
StreamId | BotId or StreamId. You can access it from the General Settings page of the bot. | string, required |
Sample Request
curl --location 'https://{{host}}/agentassist/api/v1/public/{{streamId}}/agents/{{agentId}}' \ --header 'auth: {jwt}' \ --header 'accountId: {{accountId}}' --header 'Content-Type: application/json' \
Headers
- accountId (required): The account ID associated with the API request.
- auth (required): JWT token for authentication.
Query Parameter
Parameter | Description | Type |
---|---|---|
agentId | The Agent Id of the particular agent whose details are being retrieved. You can get this from agents GET API. | string, required |
Sample Response
{ "isAccountOwner": false, "attachmentsEnabled": true, "emojisEnabled": true, "status": "ACTIVE", "firstName": "agent", "lastName": "1", "phoneNumber": "1234567890", "emailId": "agent_may15@mail.com", "customId": "", "profImage": “no-avatar", "canSupportChat": true, "maxChatSupport": 5, "roleId": "6457f21044e2ab580af1e011", "chatLanguageSupport": [ { "isActive": true, "language": "en", "proficiency": "expert" } ], "canSupportVoice": false, "voiceLanguageSupport": [ { "isActive": false, "language": "en", "proficiency": "expert" } ], "desktopLayouts": [ { "isDefault": true, "id": "ly-a3b06d5-9c8c-476a-917b-0ab45d817021" } ], "fullName": "agent 1", "lFullName": "agent 1", "userId": "u-edc0304d-05b5-5350-98da-c9748eda79f9", "accountId": "6457f21044e2ab580af1dff6", "createdBy": "u-042a7093-8178-547a-ab50-364a239b2226", "orgId": "o-0a4dcb56-5d8e-5bfa-86fc-1294e829f62e", "agentGroups": [ { "groupId": "ag-aa690c9-1a2b-4926-aa7e-2511e5e414d1", "role": "agent", "name": "grp2" } ], "lastOnlineAt": "2023-05-19T09:01:26.268Z", "createdAt": "2023-05-15T10:38:26.718Z", "updatedAt": "2023-05-23T10:20:19.178Z", "onlineStatus": "Offline", "onlineStatusType": "OFFLINE", "id": "a-953e380-2bc1-483a-a823-d9446806cc93", "nickName": "1", "role": "Supervisor", "skills": [], "queues": [ { "id": "qu-d1c05a4-99e5-4688-9156-897c959d68b3", "name": "queueuueue", "description": "quieuueue", "isPreferredAgent": true } ] }
Response Body Parameters
Parameter | Description | Type |
---|---|---|
isAccountOwner | Indicates whether the user is the account owner. | boolean |
attachmentsEnabled | Indicates whether attachments are enabled for the agent. | boolean |
emojisEnabled | Indicates whether emojis are enabled for the agent. | boolean |
status | The status of the agent. | string |
firstName | The first name of the agent. | string |
lastName | The last name of the agent. | string |
phoneNumber | The phone number of the agent. | string |
emailId | The email ID of the agent. | string |
customId | The custom ID associated with the agent. | string |
profImage | The profile image of the agent. | string |
canSupportChat | Indicates whether the agent can support chat. | boolean |
maxChatSupport | The maximum number of chat sessions the agent can support. | integer |
roleId | The ID of the role assigned to the agent. | string |
chatLanguageSupport | The chat languages supported by the agent. | array |
canSupportVoice | Indicates whether the agent can support voice calls. | boolean |
voiceLanguageSupport | The voice languages supported by the agent. | array |
desktopLayouts | The desktop layout details of the agent. | array |
fullName | The full name of the agent. | string |
lFullName | The localized full name of the agent. | string |
userId | The user ID of the agent. | string |
accountId | The ID of the account associated with the agent. | string |
createdBy | The ID of the user who created the agent. | string |
orgId | The ID of the organization associated with the agent. | string |
agentGroups | The agent group details associated with the agent. | array |
lastOnlineAt | The timestamp when the agent was last online. | string |
createdAt | The creation time of the interaction. | string |
updatedAt | The last updated time of the interaction. | string |
onlineStatus | The online status of the agent. | string |
onlineStatusType | The online status type of the agent. | string |
id | The ID of the agent. | string |
nickName | The nick name of the agent. | string |
role | The role of the agent. | string |
skills | The skills assigned to the agent. | array |
queues | The queues assigned to the agent. | array |