Get a list of groups

GET

https://example.itential.io/authorization/groups

Returns a list of groups.

AuthorizationBasic

Basic authentication of the form Basic <base64(username:password)>.

multiContainsobjectOptional

multiContains

multiEqualsobjectOptional

multiEquals

multiStartsWithobjectOptional

multiStartsWith

inactivebooleanOptional

inactive

skipintegerOptional>=0Defaults to 0

skip

limitintegerOptional>=0Defaults to 25

limit

sortenumOptionalDefaults to name

sort

Allowed values:

orderenumOptionalDefaults to 1

order

Allowed values:

refreshbooleanOptionalDefaults to false

whether to refresh groups from AAA

The groups matching the specified query.

resultsobject

This is the schema for an IAP group stored in Mongo

totalinteger>=0

The total number of documents

500

Internal Server Error

1	{
2	"results": {
3	"provenance": "Local AAA",
4	"name": "group_1",
5	"description": "description of group_1",
6	"memberOf": [
7	{
8	"aaaManaged": true,
9	"groupId": "5cb7b531d06cceb89fd21b1c"
10	}
11	],
12	"assignedRoles": [
13	{
14	"roleId": "5cb7b531d06cceb89fd21b1c"
15	}
16	],
17	"inactive": true,
18	"_meta": {
19	"created": "2018-08-02T15:56:12.912Z",
20	"updated": "2018-08-02T15:56:12.912Z"
21	}
22	},
23	"total": 1
24	}

$	curl https://example.itential.io/authorization/groups \
>	-u "<username>:<password>"