4.3.1.7 Update department information

PUT /rest/orgwise/3/department/{id}

DESCRIPTION

Modify the name, type, No., description, leader and assignee of a department. One or more of those properties can be updated at one API call. Information modification will produce change records.

MEDIA TYPE

application/json

PATH PARAM

Param	Description	Required

Param	Description	Required
id	The ID or No. of a department.	Required

REQUEST BODY

{
  "name": "Dev 2",
  "type": "DEPARTMENT",
  "no": "D3",
  "description": "",
  "leader": "username",
  "assignee": "username"
}

{
  "name": "Dev 2"
}

BODY PARAM

Param	Type	Description	Required

Param	Type	Description	Required
name	string	The name of department.	Optional
type	string	The type of department. The default is “COMPANY“ if the department is TOP class, otherwise the default is “DEPARTMENT“. Optional types are COMPANY, SUB_COMPANY, BRANCH_COMPANY, BLOC, DEPARTMENT, SUB_DEPARTMENT.	Optional
no	string	The unique No. of department.	Optional
description	string	The description of department.	Optional
leader	string	Head of department, username of Jira user.	Optional
assignee	string	Head of department, username of Jira user.	Optional

RESPONSE

{
    "code": 0,
    "msg": "Success",
    "data": {
        "id": 3,
        "no": "D4",
        "name": "Dev",
        "type": "SUB_DEPARTMENT",
        "parent": 2,
        "leader": {
            "id": 13,
            "workNumber": "E19",
            "gender": "MALE",
            "phone": "",
            "memo": "",
            "jiraUser": {
                "userKey": "JIRAUSER10116",
                "avatar": "https://www.gravatar.com/avatar/03c31b3cfde27dba0c5a6347a6bad01d?d=mm&s=16",
                "userName": "pluto154",
                "displayName": "pluto154",
                "emailAddress": "pluto154@dsd.com",
                "isActive": true
            },
            "mainDepartment": {
                "id": 1,
                "no": "D1",
                "name": "DSD",
                "type": "COMPANY",
                "createTime": "2022-03-15 11:29:20"
            },
            "departments": [
                {
                    "id": 1,
                    "no": "D1",
                    "name": "DSD",
                    "type": "COMPANY",
                    "createTime": "2022-03-15 11:29:20"
                },
                {
                    "id": 3,
                    "no": "D4",
                    "name": "Dev",
                    "type": "SUB_DEPARTMENT",
                    "createTime": "2022-03-15 13:00:39",
                    "parent": 2
                }
            ],
            "createTime": "2022-03-15 11:44:06.269"
        },
        "assignee": {
            "id": 14,
            "workNumber": "E25",
            "gender": "MALE",
            "phone": "",
            "memo": "",
            "jiraUser": {
                "userKey": "JIRAUSER10122",
                "avatar": "https://www.gravatar.com/avatar/976c543445f4973ce327b3abd1602f9d?d=mm&s=16",
                "userName": "Amy211",
                "displayName": "Amy211",
                "emailAddress": "Amy211@dsd.com",
                "isActive": true
            },
            "mainDepartment": {
                "id": 1,
                "no": "D1",
                "name": "DSD",
                "type": "COMPANY",
                "createTime": "2022-03-15 11:29:20"
            },
            "departments": [
                {
                    "id": 1,
                    "no": "D1",
                    "name": "DSD",
                    "type": "COMPANY",
                    "createTime": "2022-03-15 11:29:20"
                },
                {
                    "id": 3,
                    "no": "D4",
                    "name": "Dev",
                    "type": "SUB_DEPARTMENT",
                    "createTime": "2022-03-15 13:00:39",
                    "parent": 2
                }
            ],
            "createTime": "2022-03-15 11:44:06.269"
        },
        "parentDepartment": {
            "id": 2,
            "no": "D2",
            "name": "IT",
            "type": "DEPARTMENT",
            "createTime": "2022-03-15 13:00:39",
            "parent": 1
        },
        "rootDepartmentId": 1,
        "description": "Department",
        "createTime": "2022-03-15 13:00:39.496"
    }
}