Update Agent
Update agent details in an account.
Settings:
URL | https://online.99digital.co.il/api/v1/accounts/{account_id}/agents/{agent_id) |
Method | JSON via PATCH |
Authorization:
Header Parameter | Description |
api_access_token | user API key |
The user API key provides access to endpoints based on the user permissions levels and can be obtained by visiting the profile page.
Path Parameters:
Parameter | Description | Required |
account_id | The numeric id of the account | yes |
agent_id | The numeric id of the agent | yes |
Request body:
Parameter | type | Description | Required |
role | string | Whether its administrator or agent Enum: | yes |
availability_status | string | The availability setting of the agent Enum: | no |
auto_offline | boolean | Whether the availability status of agent is configured to go offline automatically when away | no |
Response:
{
"id": 0,
"account_id": 0,
"availability_status": "available",
"auto_offline": true,
"confirmed": true,
"email": "string",
"available_name": "string",
"name": "string",
"role": "agent",
"see_all_conversations": false,
"thumbnail": ""
}
Response-Explain:
Parameter | Description |
id | Agent numeric id |
account_id | Account numeric id |
availability_status | The availability status of the agent Enum: |
auto_offline | Whether the availability status of agent is configured to go offline automatically when away |
confirmed | whether or not the agent's account has been validated by clicking on the invitation email they received |
Email of the agent | |
available_name | |
name | Full name of the agent |
role | Whether its administrator or agent. Enum: |
see_all_conversations | Whether an agent can see all conversations |
thumbnail | Agent thumbnail |