Update agent

PATCH {{baseUrl}}/api/v1/agents/:agent_id

This API updates details of an agent.

OAuth Scope

  • Desk.settings.UPDATE
  • Desk.basic.UPDATE

Attributes

Attribute NameData TypeDescription
emailId<string>
max chars : 100
Email ID of the agent
lastName<string>
max chars : 50
Last name of the agent
firstName<string>
max chars : 50
First name of the agent
phone<string>
max chars : 100
Phone number of the agent
mobile<string>
max chars : 100
Mobile number of the agent
extn<string>
max chars : 100
Extension number of the agent
associatedDepartmentIds<list>
Departments with which the agent is associated
associatedChatDepartmentIds<list>
Chat departments with which the agent is associated
rolePermissionType<string>
max chars : 100
The Role Permission type of Agent
aboutInfo<string>
max chars : 255
Agent's about info
channelExpert<list>
The channels handled for the Agent
countryCode<string>
max chars : 100
Country code of the agent. Agents can update only their countryCode. They cannot update the countryCode of other users.
timeZone<string>
max chars : 100
The timeZone of the agent. Eg Asia/Calcutta, Europe/Moscow. One can update his own timeZone only. If it is passed for other agent it will be ignored.
langCode<string>
max chars : 100
Language code of the agent. Agents can update only their langCode. They cannot update the langCode of other users.

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring

RESPONSES

status: OK

{&quot;lastName&quot;:&quot;Marisol Walsh&quot;,&quot;extn&quot;:&quot;3298&quot;,&quot;roleId&quot;:&quot;1892000000056099&quot;,&quot;langCode&quot;:&quot;fr_FR&quot;,&quot;mobile&quot;:&quot;&quot;,&quot;timeZone&quot;:&quot;Pacific/Majuro&quot;,&quot;emailId&quot;:&quot;marisol51@zylker.com&quot;,&quot;associatedChatDepartmentIds&quot;:[],&quot;zuid&quot;:&quot;10687231&quot;,&quot;associatedDepartmentIds&quot;:[&quot;1892000000006907&quot;,&quot;1892000000082069&quot;],&quot;firstName&quot;:&quot;K&quot;,&quot;photoURL&quot;:null,&quot;phone&quot;:&quot;764-484-8068&quot;,&quot;profileId&quot;:&quot;1892000000056091&quot;,&quot;countryCode&quot;:&quot;en_US&quot;,&quot;channelExpert&quot;:[&quot;Facebook&quot;,&quot;Email&quot;,&quot;Forums&quot;],&quot;name&quot;:&quot;K Marisol Walsh&quot;,&quot;rolePermissionType&quot;:&quot;Admin&quot;,&quot;isConfirmed&quot;:true,&quot;aboutInfo&quot;:&quot;Expert in handling Reports&quot;,&quot;id&quot;:&quot;1892000000056007&quot;,&quot;status&quot;:&quot;ACTIVE&quot;}