Group admin API Resource

Abstract class for REST webservices

POST /admin/group

Add group.

Example of request:

{"name":"Special Users","description":"Group for users with special rights","distinguishedName":"Internal=SpecialUsers","providerName":"Internal"}

Request Body
media type data type
application/json object
Response Body
media type data type description
application/json object JSON Response with information, whether the adding has or has not been succeeded.

POST /admin/group/addmember

Add member to group

Example of request:

{"list":[{"id":"user1Id"},{"id":"user2Id"}]}

Request Body
media type data type description
application/json object The list of users.
Response Body
media type data type description
application/json object JSON Response with information, whether the adding has or has not been succeeded.

POST /admin/group/removemember

Remove member from group

Example of request:

{"list":[{"id":"user1Id"},{"id":"user2Id"}]}

Request Body
media type data type description
application/json object The list of users.
Response Body
media type data type description
application/json object JSON Response with information, whether the removing has or has not been succeeded.

DELETE /admin/group/{groupId}

Remove group

Request Parameters
name type description default constraints
groupId path ID of group   long
Response Body
media type data type description
application/json object JSON Response with information, whether the removing has or has not been succeeded.

PUT /admin/group/{groupId}

Update group.

Example of request:

{"name":"Special Users","description":"Group for users with special rights"}

Request Parameters
name type description default constraints
groupId path   long
Request Body
media type data type description
application/json object The specification of group that has to be updated.
Response Body
media type data type description
application/json object JSON Response with information, whether the updating has or has not been succeeded.

GET /admin/group/json/{groupId}

Get list of group members

Request Parameters
name type description default constraints
groupId path ID of group    
Response Body
media type data type description
application/json object JSON with list of users

Example of response:

{"list":[{"id":1,"name":"admin","userFullName":"Admin","description":"","enabled":true,"email":"","loginCount":1840,"lastLoginDate":"2013-09-26T10:18:36.199072+02:00"},{"id":2,"name":"user1","userFullName":"User 1","description":"","enabled":true,"email":"","loginCount":784,"lastLoginDate":"2013-09-25T13:16:12.990218+02:00"}]}

POST /admin/group/register/{providerId}

register multiple external group

Example of request:

{"list":["{\"description\":\"Ordinary users\",\"dn\":\"CN=Users,CN=Builtin,DC=INTERDESIGN\",\"cn\":\"Users\"}"]}

Request Parameters
name type description default constraints
providerId path ID of group    
Request Body
media type data type description
application/json string The list of users.
Response Body
media type data type description
application/json object JSON Response with information, whether the adding has or has not been succeeded.