4.2.1.7 Update department information
PUT /rest/orgwise/2/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 |
---|---|---|
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 |
---|---|---|---|
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"
}
}