GET/groups
Gets a list of groups.
OAuth 2.0 authentication.
For more information, see Authentication and Authorization.
directory
directory.read
group
group.read
| Parameter | Type | Description |
|---|---|---|
| domainId | integer | Domain ID example : 10000001 format : int32 |
| count | integer | Number of items to get default : 100 minimum : 1 maximum : 100 example : 100 format : int32 |
| cursor | string | Cursor example : JlIBsfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA== |
| Header | type | Description |
|---|---|---|
| Authorization | string | Bearer {token} required |
OK
| Property | Type | Description |
|---|---|---|
| groups | array (Group) | Group information |
| responseMetaData | object (responseMetaData) | Response metadata |
| Property | Type | Description |
|---|---|---|
| domainId | integer | Domain ID required format : int32 |
| groupId | string | It is automatically assigned. readOnly : true |
| groupName | string | Group name. It must be unique within the domain. required maxLength : 100 |
| description | string | Group description maxLength : 300 nullable : true |
| visible | boolean | Indicates whether to make the group visible. It indicates whether to make the group visible in search results for users who are not managers or members. default : true |
| useServiceNotification | boolean | Indicates whether to send service notifications. default : false |
| serviceManageable | boolean | Indicates whether a group master can change whether to use the service. default : true |
| groupExternalKey | string | Group external key maxLength : 100 nullable : true |
| administrators | array (GroupAdministrator) | List of group masters required minItems : 1 |
| members | array (GroupMember) | List of group members required |
| useMessage | boolean | Indicates whether to use the Message Room features.
default : false |
| useNote | boolean | Indicates whether to use the Message Room Note feature.
default : false |
| useCalendar | boolean | Indicates whether to use the Message Room Calendar feature.
default : false |
| useTask | boolean | Indicates whether to use the Message Room Task feature.
default : false |
| useFolder | boolean | Indicates whether to use the Message Room Folder feature.
default : false |
| useMail | boolean | Indicates whether to use group emails.
default : false |
| groupEmail | string | Group email address (if
minItems : 0 maxLength : 90 |
| aliasEmails | array (string) | Group email alias (if
minItems : 0 maxItems : 20 |
| canReceiveExternalMail | boolean | Indicates whether to receive external emails (if default : false |
| toExternalEmails | array (string) | External email addresses to receive group emails. minItems : 0 maxItems : 500 |
| membersAllowedToUseGroupEmailAsRecipient | array (GroupAllowedMember) | Members who can send an email to the group email address (if minItems : 0 |
| membersAllowedToUseGroupEmailAsSender | array (GroupAllowedMember) | Members who can use the group email address as their From address (if minItems : 0 |
| useDynamicMembership | boolean | Indicates whether to enable dynamic membership.
default : false |
| dynamicMembership | object (dynamicMembership) | Dynamic membership |
| Property | Type | Description |
|---|---|---|
| userExternalKey | string | Member external key readOnly : true |
| userId | string | Member ID required |
| Property | Type | Description |
|---|---|---|
| externalKey | string | Member external key readOnly : true |
| id | string | Member, team, or group ID. required |
| type | string | required Allowed values : USER, ORGUNIT, GROUP |
| Property | Type | Description |
|---|---|---|
| userExternalKey | string | Member external key readOnly : true |
| userId | string | Member ID required |
| Property | Type | Description |
|---|---|---|
| query | string | Membership query. maxLength : 10000 |
| excludeUserIds | array (string) | List of member IDs to exclude from the group. The following types are available:
minItems : 0 |
| Property | Type | Description |
|---|---|---|
| nextCursor | string | Cursor value for pagination |
example
1{2 "groups": [3 {4 "domainId": 10000001,5 "groupId": "group127-8545-4463-603b-04d550d23bf",6 "groupName": "Group1",7 "description": "Domain group",8 "visible": true,9 "useServiceNotification": true,10 "serviceManageable": true,11 "groupExternalKey": "GROUP_EXT_01",12 "administrators": [13 {14 "userExternalKey": "USER_EXT_01",15 "userId": "userf7da-f82c-4284-13e7-030f3b4c756x"16 }17 ],18 "members": [19 {20 "externalKey": "USER_EXT_01",21 "id": "userf7da-f82c-4284-13e7-030f3b4c756x",22 "type": "USER"23 },24 {25 "externalKey": "ORGUNIT_EXT_01",26 "id": "orgunitf-f27f-4af8-27e1-03817a911417",27 "type": "ORGUNIT"28 },29 {30 "externalKey": "GROUP_EXT_01",31 "id": "group769-e656-477d-69c7-04e2f73a4a77",32 "type": "GROUP"33 }34 ],35 "useMessage": true,36 "useNote": true,37 "useCalendar": true,38 "useFolder": true,39 "useTask": true,40 "useMail": true,41 "groupEmail": "group01@example.com",42 "aliasEmails": [43 "alias@example.com"44 ],45 "canReceiveExternalMail": true,46 "toExternalEmails": [47 "external@example.com"48 ],49 "membersAllowedToUseGroupEmailAsRecipient": [50 {51 "userExternalKey": "USER_EXT_01",52 "userId": "userf7da-f82c-4284-13e7-030f3b4c756x"53 }54 ],55 "membersAllowedToUseGroupEmailAsSender": [56 {57 "userExternalKey": "USER_EXT_01",58 "userId": "userf7da-f82c-4284-13e7-030f3b4c756x"59 }60 ]61 },62 {63 "domainId": 10000001,64 "groupId": "groupa36-79c8-4858-6c23-041098774484",65 "groupName": "Group 2",66 "visible": false,67 "useServiceNotification": true,68 "serviceManageable": true,69 "groupExternalKey": "GROUP_EXT_02",70 "administrators": [71 {72 "userExternalKey": "USER_EXT_02",73 "userId": "user6362-21a9-1kbc-1234-126e09fcegd1"74 }75 ],76 "members": [77 {78 "externalKey": "USER_EXT_01",79 "id": "userf7da-f82c-4284-13e7-030f3b4c756x",80 "type": "USER"81 },82 {83 "externalKey": "ORGUNIT_EXT_02",84 "id": "orgunit7-f511-4757-6040-044af9c9742d",85 "type": "ORGUNIT"86 }87 ],88 "useMessage": true,89 "useNote": true,90 "useCalendar": true,91 "useFolder": true,92 "useTask": true,93 "useMail": true,94 "groupEmail": "group02@example.com",95 "aliasEmails": [96 "alias2@example.com"97 ],98 "canReceiveExternalMail": false,99 "useDynamicMembership": true,100 "dynamicMembership": {101 "query": "user.levelId == levelaa7-b824-4937-66af-042f1f43cefa",102 "excludeUserIds": [103 "userf7da-f82c-4284-13e7-030f3b4c756x"104 ]105 }106 }107 ],108 "responseMetaData": {109 "nextCursor": "JlIBsfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA=="110 }111}