System group list
OVERVIEW
This API call is used to get a list of system groups.
Note:
The following changes have been made to this API endpoint
- Introduced sorting
- Added following additional items to the return object createddate, totalcount, total, nooforganisation
HTTP Request
GET /api/3/groups? {parameters}
Parameters | Description |
type | org (Organisation Auto created groups) synced (Groups imported from an external system like Active Directory) system (System groups) |
sort |
Allow ascending and descending sorting of a single field. GET /api/3/groups?ordertype=createddate This returns a list of groups sorted by createddate in ascending order. possible fields: createddate |
order by |
Allow ascending and descending sorting of a single field. GET /api/3/groups?orderby=desc possible fields: asc,desc |
Example
GET http://example.com/context/api/3/groups?ordertype=createddate&orderby=desc&type=org
HTTP Response
Success
HTTP response 200
Error
XML response
<groups>
<total>46</total>
<totalcount>11</totalcount>
<group>
<id>12</id>
<name>aabbcWc</name>
<description></description>
<type>org</type>
<numberofusers>0</numberofusers>
<createddate>15 Mar 2018 14:26</createddate>
<nooforganisation>0</nooforganisation>
</group>
</groups>
Where "total" represents the total no of system groups in the system and "totalcount" is the no of groups returned in the response based on the filter criteria.
JSON response
{
"total": "46",
"totalcount": "11",
"group": {
"id": "12",
"name": "aabbcWc",
"description": "",
"type": "org",
"numberofusers": "0",
"createddate": "15 Mar 2018 14:26",
"nooforganisation": "0"
}
}
Where
"total" is the total number of system groups in the instance
"totalcount" is the total no of groups returned in this API response based on the specific filter.
Error messages
Summary | Ref Code (before V4) | Ref Code (V4) |
Invalid value provided in type, valid values are org, system or synced | 146 | 146 |
The ordertype is invalid. createddate is supported ordertype | 150 | 150 |
The orderby value is invalid. asc and desc are supported orderby values. | 151 | 151 |
Comments
0 Comments