Update department

PATCH {{baseUrl}}/api/v1/departments/:department_id

This API updates the details of an existing department.

OAuth Scope

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

Attributes

Attribute NameData TypeDescription
name<string>
max chars : 150
Name of the department
nameInCustomerPortal<string>
max chars : 150
Display name of the department in the help center
description<string>
max chars : 500
A short description of the department
isVisibleInCustomerPortal<boolean>
Key that denotes if the department is visible in the help center or not
isAssignToTeamEnabled<boolean>
Key that denotes if the assign to team functionality is enabled or not
associatedAgentIds<list>
IDs of agents associated with the department

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring

RESPONSES

status: OK

{&quot;isAssignToTeamEnabled&quot;:true,&quot;chatStatus&quot;:&quot;DISABLED&quot;,&quot;hasLogo&quot;:false,&quot;isVisibleInCustomerPortal&quot;:true,&quot;creatorId&quot;:&quot;1892000000042001&quot;,&quot;description&quot;:&quot;With the most advanced technology, the zPhone is the world’s largest selling smartphone.&quot;,&quot;associatedAgentIds&quot;:[&quot;1892000000042001&quot;,&quot;1892000000056007&quot;],&quot;isDefault&quot;:false,&quot;isEnabled&quot;:true,&quot;name&quot;:&quot;zPhone&quot;,&quot;createdTime&quot;:&quot;2019-07-26T13:11:02.000Z&quot;,&quot;id&quot;:&quot;1892000000082085&quot;,&quot;nameInCustomerPortal&quot;:&quot;zPhone Support&quot;}