| Name | Description |
|---|
| 1 | | | Panel |
|---|
| borderColor | black |
|---|
| bgColor | #fbfff5 |
|---|
| borderStyle | solid |
|---|
| | Add a new user account. |
Name | Description |
|---|
| URL | /user | | HTTP Method | POST | | Body Parameters | | Parameter | Description |
|---|
| id | User ID of user. | | username | Username of user. | | firstName | User's first name. | | lastName | User's last name. | | email | User's email. | | active | User's account active status. | | timeZone | User's time zone. | | locale | User's locale. |
| | Sample Response | | Code Block |
|---|
| {
"id": "apiUser",
"username": "apiUser",
"firstName": "API",
"lastName": "User",
"email": "",
"active": 1,
"timeZone": "",
"locale": ""
} |
|
|
| 2 | | | Panel |
|---|
| borderColor | black |
|---|
| bgColor | #fbfff5 |
|---|
| borderStyle | solid |
|---|
| | Delete a user account. |
Name | Description |
|---|
| URL | /user/{username} | | HTTP Method | DELETE | | Path Parameters | | Parameter | Description |
|---|
| username | Username of a Joget user. |
| | Sample Response | | Code Block |
|---|
| {
"date": "Fri Aug 30 00:38:43 SGT 2019",
"code": "200",
"message": "Successful operation"
} |
|
|
| 3 | | Anchor |
|---|
| Find HOD by username |
|---|
| Find HOD by username |
|---|
|
Find HOD by username
| | Panel |
|---|
| borderColor | black |
|---|
| bgColor | #fbfff5 |
|---|
| borderStyle | solid |
|---|
| | Find the HOD of the department that the specified user belongs to, via username. |
Name | Description |
|---|
| URL | /user/findHod/{username} | | HTTP Method | GET | | Path Parameters | | Parameter | Description |
|---|
| username | Username of a Joget user. |
| | Sample Response | | Code Block |
|---|
| [
{
"id": "clark",
"username": "clark",
"firstName": "Clark",
"lastName": "Kent",
"email": "",
"active": 1,
"timeZone": "",
"locale": null
}
] |
|
|
| 4 | | Anchor |
|---|
| Find subordinate by username |
|---|
| Find subordinate by username |
|---|
|
Find subordinate by username
| | Panel |
|---|
| borderColor | black |
|---|
| bgColor | #fbfff5 |
|---|
| borderStyle | solid |
|---|
| | Find all users that report to the specified user, via username. |
Name | Description |
|---|
| URL | /user/findSubordinate/{username} | | HTTP Method | GET | | Path Parameters | | Parameter | Description |
|---|
| username | Username of a Joget user. |
| | Sample Response | | Code Block |
|---|
| [
{
"id": "clark",
"username": "clark",
"firstName": "Clark",
"lastName": "Kent",
"email": "",
"active": 1,
"timeZone": "",
"locale": null
},
.....
] |
|
|
| 5 | | | Panel |
|---|
| borderColor | black |
|---|
| bgColor | #fbfff5 |
|---|
| borderStyle | solid |
|---|
| Get user details of all users by default. Able to filter or sort the returned results via parameters. |
Name | Description |
|---|
| URL | /user/find | | HTTP Method | GET | | Query String Parameters | | Parameter | Description |
|---|
| nameFilter | Filters the response via user ID. | | organizationId | Filter users that belong to an organization, via organization ID. | | departmentId |
| | gradeId |
| | groupId |
| | roleId |
| | active |
| | sort | User 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. | | startOffset | Starting position of records to start query. Expects an integer. | | pageSize | Number of results to return. Expects an integer. |
| | Sample Response | | Code Block |
|---|
| [
{
"id": "admin",
"username": "admin",
"firstName": "Admin",
"lastName": "Admin",
"email": null,
"active": 1,
"timeZone": "0",
"locale": null
},
.....
] |
|
|
| 6 | | Anchor |
|---|
| Get Department HOD |
|---|
| Get Department HOD |
|---|
|
Get Department HOD
| | Panel |
|---|
| borderColor | black |
|---|
| bgColor | #fbfff5 |
|---|
| borderStyle | solid |
|---|
| | Get user details of the HOD of the department, via department ID. |
|
| 7 | | Anchor |
|---|
| Get employment info |
|---|
| Get employment info |
|---|
|
Get employment info
| | Panel |
|---|
| borderColor | black |
|---|
| bgColor | #fbfff5 |
|---|
| borderStyle | solid |
|---|
| | Get employment details of a user via username. |
|
| 8 | | Anchor |
|---|
| Get roles by username |
|---|
| Get roles by username |
|---|
|
Get roles by username
| | Panel |
|---|
| borderColor | black |
|---|
| bgColor | #fbfff5 |
|---|
| borderStyle | solid |
|---|
| | Get the roles (e.g: regular user or Joget administrator) of a user via username. |
|
| 9 | | Anchor |
|---|
| Get user by username |
|---|
| Get user by username |
|---|
|
Get user by username
| | Panel |
|---|
| borderColor | black |
|---|
| bgColor | #fbfff5 |
|---|
| borderStyle | solid |
|---|
| | Get user details of a user via username. |
|
| 10 | | | Panel |
|---|
| borderColor | black |
|---|
| bgColor | #fbfff5 |
|---|
| borderStyle | solid |
|---|
| | Update the user details of a user. |
|