Update team

PATCH {{baseUrl}}/api/v1/teams/:team_id

This API updates details of an existing team.

OAuth Scope

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

Attributes

Attribute NameData TypeDescription
name<String>
Name of the team
description<String>
A short description of the team
subTeams<list>
List of sub-teams within the team
roles<list>
List of roles to add to the team
rolesWithSubordinates<list>
List of roles with subordinates to add to the team
agents<list>
List of agents to add to the team

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring

RESPONSES

status: OK

{&quot;rolesWithSubordinates&quot;:[&quot;6000000008684&quot;,&quot;6000000008686&quot;],&quot;departmentId&quot;:&quot;6000000009893&quot;,&quot;roles&quot;:[&quot;6000000011311&quot;,&quot;6000000011307&quot;],&quot;name&quot;:&quot;Sales Reps.&quot;,&quot;description&quot;:&quot;Sales teams for winning customers.&quot;,&quot;derivedAgents&quot;:[&quot;6000000009086&quot;,&quot;6000000012003&quot;],&quot;id&quot;:&quot;6000000014007&quot;,&quot;subTeams&quot;:[&quot;6000000011303&quot;],&quot;agents&quot;:[&quot;6000000009086&quot;]}