Department Update APIAPI Explorer

Introduction

API Introduction

Department Update API enables you to update the information of a specified department.

API Version

API Version

Updated Time

Version Description

V1

2022.10.28

The API request frequency is increased from five times/second to 20 times/second. The API route is changed to POST corp/department/update.

V2

2023.08.01

A new response parameter called "seq" has been added. This parameter allows for sorting departments within their parent department.

API Calling

The API enables you to update the information of a specified department.

Request URL: https://api.jodoo.com/api/v5/corp/department/update

Request Frequency: 20 times per second

Request Method: POST

Request Parameters:

Parameter

Required

Type

Description

name

No

String

Department name

parent_ no

No

Integer

ID of the department's superior department

dept_no

Yes

Number

Department ID

Note:

At least one of the "name", "parent_no", and "seq" parameters must be filled in the request parameters.

Sample Request:

{
    "name": "Product department",
    "parent_no": 1,
    "dept_no": 25
    "seq": 1
}

Responses:

Parameter

Type

Description

department

JSON

The information of the created department

department.dept_no

Number

Department number

department.name

String

Department name

department.parent_no

Number

Parent department number

type

Number

Department type

status

Number

Departmental status

seq

Number

Department sorting

Sample Response:

{
  "department": {
    "dept_no": 3,
    "name": "Product department",
    "parent_no": 2,
    "type": 0,
    "status": 1
    "seq": 1
  }
}

Was this information helpful?
Yes
NoNo
Need more help? Contact support