Department API can perform functions to interact or exchange data for Department.


NameDescription
1

Add department

Add a new department.

Name

Description
URL/department
HTTP MethodPOST
Body Parameters
ParameterDescription
idDepartment ID.
nameDepartment name.
descriptionDescription of department.
Sample Response
{
  "id": "apiTestDept",
  "name": "API TEST Department",
  "description": "This is a department created by API."
}
2

Delete department

Delete a department via department ID.

Name

Description
URL/department/{id}
HTTP MethodDELETE
Path Parameters
ParameterDescription
idDepartment ID.
Sample Response
{
  "date": "Wed Aug 28 01:29:38 SGT 2019",
  "code": "200",
  "message": "Successful operation"
}
3

Find department

Gets all departments from all organizations by default.

Able to filter or sort the returned results via parameters.

Name

Description
URL/department/find
HTTP MethodGET
Query String Parameters
ParameterDescription
nameFilterFilters the response via department ID.
organizationIdFilter departments that belong to an organization, via organization ID.
sort

Department data column to sort.

Must be used in conjunction with "sortDescending" parameter.

sortDescending

Sort the specified "sort" parameter value in ascending or descending order.

Expects a boolean value.

Must be used in conjunction with "sort" parameter.

startOffsetStarting position of records to start query. Expects an integer.
pageSizeNumber of results to return. Expects an integer.
Sample Response
[
  {
    "id": "D-001",
    "name": "CEO Office",
    "description": ""
  },
  {
    "id": "D-002",
    "name": "Human Resource and Admin",
    "description": ""
  },
	.....
]
4

Get department by ID

Get details of a department via department ID.

Name

Description
URL/department/{id}
HTTP MethodGET
Path Parameters
ParameterDescription
idDepartment ID.
Sample Response
{
  "id": "D-001",
  "name": "CEO Office",
  "description": ""
}
5

Update department

Update the details of a department.

Name

Description
URL/department
HTTP MethodPUT
Body Parameters
ParameterDescription
idDepartment ID.
nameDepartment name.
descriptionDescription of department.
Sample Response
{
  "id": "apiTestDept",
  "name": "API TEST Department",
  "description": "I update this department description via API."
}