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 |