GET/groups/{groupId}/administrators

Gets a list of group masters. This API operation cannot get an external group.

Authorization

oauth2

OAuth 2.0 authentication.
For more information, see Authentication and Authorization.

Scope

directory
directory.read
group
group.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/groups/{groupId}/administrators

Path Parameters

ParameterTypeDescription
groupId string 

Group ID or external key.
External key in "externalKey:{externalKey}" format


required 

Query Parameters

ParameterTypeDescription
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 Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 
Content-Type string 

application/json


required
example : application/json 

Response

HTTP 200

OK

PropertyTypeDescription
administrators array (GroupAdministrator) 

List of group masters

 
responseMetaData object (responseMetaData) 

Response metadata

 

GroupAdministrator

PropertyTypeDescription
userExternalKey string 

Member external key


readOnly : true 
userId string 

Member ID
- Email address
- Resource ID
- External key in "externalKey:{externalKey}" format


required 

responseMetaData

PropertyTypeDescription
nextCursor string 

Cursor value for pagination

 

Response Example

example

1{2  "administrators": [3    {4      "userExternalKey": "USER_EXT_01",5      "userId": "userf7da-f82c-4284-13e7-030f3b4c756x"6    }7  ],8  "responseMetaData": {9    "nextCursor": "JlIBsfJogXpzDGY8OscZziqZpYqCAu3RbZbaFzBb1od6lWQtSdPUd2FIdCuaGgu8DA=="10  }11}

HTTP 400

Bad Request

HTTP 403

Forbidden

HTTP 404

Not Found