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" } }