Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
borderColorgreen
borderWidth1
titleBGColor#ddffcc
borderStylesolid
titleDefinition

Group API can perform functions to interact or exchange data for with Groups.


NameDescription
1

Anchor
Add group
Add group
Add group

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Add a new group.

Name

Description
URL/group
HTTP MethodPOST
Body Parameters
ParameterDescription
idGroup ID.
nameGroup name.
descriptionDescription of group.
Sample Response
Code Block
languagejs
{
  "id": "apiTestGroup",
  "name": "API Test Group",
  "description": "This is a group created by API."
}
2

Anchor
Delete group
Delete group
Delete group

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Delete a group via group ID.

Name

Description
URL/group/{id}
HTTP MethodDELETE
Path Parameters
ParameterDescription
idGroup ID.
Sample Response
Code Block
languagejs
{
  "date": "Wed Aug 28 16:13:00 SGT 2019",
  "code": "200",
  "message": "Successful operation"
}
3

Anchor
Find group
Find group
Find group

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Get all groups by default.

Able to filter or sort the returned results via parameters.

Name

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

Group 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
Code Block
languagejs
[
  {
    "id": "G-001",
    "name": "Managers",
    "description": ""
  },
  {
    "id": "G-002",
    "name": "CxO",
    "description": ""
  },
	.....
]
4

Anchor
Find group by username
Find group by username
Find group by username

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Find the group that belongs to the specified user via username.

Name

Description
URL/group/findByUser/{username}
HTTP MethodGET
Path Parameters
ParameterDescription
usernameUsername of a Joget user.
Query String Parameters
ParameterDescription
nameFilterFilters the response via group ID.
organizationIdFilter groups that belong to an organization, via organization ID.
sort

Group 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
Code Block
languagejs
[
  {
    "id": "G-001",
    "name": "Managers",
    "description": ""
  }
]
5

Anchor
Get group by ID
Get group by ID
Get group by ID

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Get details of a group via group ID.

Name

Description
URL/group/{id}
HTTP MethodGET
Path Parameters
ParameterDescription
idGroup ID.
Sample Response
Code Block
languagejs
{
  "id": "G-002",
  "name": "CxO",
  "description": ""
}
6

Anchor
Update group
Update group
Update group

Panel
borderColorblack
bgColor#fbfff5
borderStylesolid

Update the details of a group.

Name

Description
URL/group
HTTP MethodPUT
Body Parameters
ParameterDescription
idGroup ID.
nameGroup name.
descriptionDescription of group.
Sample Response
Code Block
languagejs
{
  "id": "apiTestGroup",
  "name": "API Test Group",
  "description": "This group is updated via API."
}

...