Organization API can interact with Organization and its users.
| Name | Description |
|---|
| 1 | | Name | Description |
|---|
| URL | /organization | | HTTP Method | POST | | Body Parameters | | Parameter | Description |
|---|
| id | Organization ID. | | name | Organization name. | | description | Description of organization. |
| | Sample Response |
{
"id": "apiTestOrg",
"name": "API Test Org",
"description": "This is an organization created by API."
}
|
|
| 2 | Assign user to organization |
Assign a Joget user to an organization.
Name | Description |
|---|
| URL | /organization/assignUser/{organization}/{username} | | HTTP Method | POST | | Path Parameters | | Parameter | Description |
|---|
| organization | Organization ID. | | username | Username of Joget user. |
| | Sample Response |
{
"userId": "david",
"startDate": null,
"endDate": null,
"employeeCode": null,
"gradeId": "G-002",
"departmentId": "D-007",
"organizationId": "ORG-001"
}
|
|
| 3 | |
Delete an organization via organization ID.
Name | Description |
|---|
| URL | /organization/{id} | | HTTP Method | DELETE | | Path Parameters | | Parameter | Description |
|---|
| id | Organization ID. |
| | Sample Response |
{
"date": "Wed Aug 28 15:43:58 SGT 2019",
"code": "200",
"message": "Successful operation"
}
|
|
| 4 | |
Gets all organizations by default. Able to filter or sort the returned results via parameters.
Name | Description |
|---|
| URL | /organization/find | | HTTP Method | GET | | Query String Parameters | | Parameter | Description |
|---|
| nameFilter | Filters the response via organization ID. | | sort | Organization 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 |
[
{
"id": "ORG-001",
"name": "Joget.Org",
"description": ""
}
]
|
|
| 5 | |
Get details of a organization via organization ID.
Name | Description |
|---|
| URL | /organization/{id} | | HTTP Method | GET | | Path Parameters | | Parameter | Description |
|---|
| id | Organization ID. |
| | Sample Response |
[
{
"id": "ORG-001",
"name": "Joget.Org",
"description": ""
}
]
|
|
| 6 | Unassign user from organization |
Unassign a Joget user from an organization.
Name | Description |
|---|
| URL | /organization/unassignUser/{organization}/{username} | | HTTP Method | DELETE | | Path Parameters | | Parameter | Description |
|---|
| organization | Organization ID. | | username | Username of Joget user. |
| | Sample Response |
{
"date": "Thu Dec 05 03:29:56 SGT 2019",
"code": "200",
"message": "Successful operation"
}
|
|
| 7 | |
Update the details of a organization.
Name | Description |
|---|
| URL | /organization | | HTTP Method | PUT | | Body Parameters | | Parameter | Description |
|---|
| id | Organization ID. | | name | Organization name. | | description | Description of organization. |
| | Sample Response |
{
"id": "apiTestOrg",
"name": "API Test Org",
"description": "This organization is updated via API."
}
|
|