GET

Get group

Retrieves a group

Request

Query parameters

groupname

string

Responses

the operation succeeded and the group is retrieved

application/json application/xml

any

GET/rest/usermanagement/1/group
1 2 3 curl --request GET \ --url 'http://{baseurl}/rest/rest/usermanagement/1/group' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 { "link": { "href": "link_to_group", "rel": "self" }, "name": "groupname", "description": "Group Description", "type": "GROUP", "active": true, "attributes": { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/group/attributes?groupname=groupname", "rel": "self" }, "attribute": [] } }
PUT

Update group

Updates an existing group

Request

Query parameters

groupname

string

Request bodyapplication/json application/xml

the update data

active

boolean

attributes

MultiValuedAttributeEntityList

description

string

expanded

boolean

link

Link

name

string

type

string

Responses

returned if the group previously existed and is now updated

application/json application/xml

any

PUT/rest/usermanagement/1/group
1 2 3 4 5 6 7 8 9 10 11 12 13 curl --request PUT \ --url 'http://{baseurl}/rest/rest/usermanagement/1/group' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "link": null, "name": "newgroupname", "description": "description", "type": "GROUP", "active": null, "attributes": null, "expanded": true }'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 { "link": { "href": "link_to_group", "rel": "self" }, "name": "groupname", "description": "Group Description", "type": "GROUP", "active": true, "attributes": { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/group/attributes?groupname=groupname", "rel": "self" }, "attribute": [] } }
POST

Add group

Adds a new group

Request

Request bodyapplication/json application/xml

the group to create

active

boolean

attributes

MultiValuedAttributeEntityList

description

string

expanded

boolean

link

Link

name

string

type

string

Responses

the operation succeeded and the group is successfully created

application/json application/xml

any

POST/rest/usermanagement/1/group
1 2 3 4 5 6 7 8 9 10 11 12 13 curl --request POST \ --url 'http://{baseurl}/rest/rest/usermanagement/1/group' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "link": null, "name": "newgroupname", "description": "description", "type": "GROUP", "active": null, "attributes": null, "expanded": true }'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 { "link": { "href": "link_to_group", "rel": "self" }, "name": "groupname", "description": "Group Description", "type": "GROUP", "active": true, "attributes": { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/group/attributes?groupname=groupname", "rel": "self" }, "attribute": [] } }
DEL

Delete group

Deletes a group

Request

Query parameters

groupname

string

Responses

returned if the group was found and deleted

DEL/rest/usermanagement/1/group
1 2 curl --request DELETE \ --url 'http://{baseurl}/rest/rest/usermanagement/1/group'
GET

Get group attributes

Retrieves a list of group attributes

Request

Query parameters

groupname

string

Responses

returned if the group attribute was found

application/json application/xml

any

GET/rest/usermanagement/1/group/attribute
1 2 3 curl --request GET \ --url 'http://{baseurl}/rest/rest/usermanagement/1/group/attribute' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/group/attributes?username=sampleuser", "rel": "self" }, "attribute": [ { "link": { "href": "https://crowdserver/crowd", "rel": "self" }, "name": "attribute", "values": [ "value1", "value2" ] } ] }
POST

Save group attributes

Stores the group attributes

Request

Query parameters

groupname

string

Request bodyapplication/json application/xml

the attributes to store

attributes

array<MultiValuedAttributeEntity>

callback

ListWrapperCallbackMultiValuedAttributeEntity

empty

boolean

link

Link

Responses

returned if the group attributes are successfully set

POST/rest/usermanagement/1/group/attribute
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 curl --request POST \ --url 'http://{baseurl}/rest/rest/usermanagement/1/group/attribute' \ --header 'Content-Type: application/json' \ --data '{ "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/group/attributes?username=sampleuser", "rel": "self" }, "attribute": [ { "link": { "href": "https://crowdserver/crowd", "rel": "self" }, "name": "attribute", "values": [ "value1", "value2" ] } ] }'
DEL

Delete group attribute

Deletes a group attribute

Request

Query parameters

groupname

string

attributename

string

Responses

returned if the group attribute is successfully deleted

DEL/rest/usermanagement/1/group/attribute
1 2 curl --request DELETE \ --url 'http://{baseurl}/rest/rest/usermanagement/1/group/attribute'
GET

Get direct group children

Retrieves the groups that are direct children of the specified group or a single direct child of that group with the specified name

Request

Query parameters

groupname

string

Required
child-groupname

string

start-index

integer

max-results

integer

Responses

returned if the group was found

application/json application/xml

any

GET/rest/usermanagement/1/group/child-group/direct
1 2 3 curl --request GET \ --url 'http://{baseurl}/rest/rest/usermanagement/1/group/child-group/direct?groupname={groupname}' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 { "group": [ { "link": { "href": "link_to_group", "rel": "self" }, "name": "groupname", "description": "Group Description", "type": "GROUP", "active": true, "attributes": { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/group/attributes?groupname=groupname", "rel": "self" }, "attribute": [] } }, { "link": { "href": "link_to_group", "rel": "self" }, "name": "groupname", "description": "Group Description", "type": "GROUP", "active": true, "attributes": { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/group/attributes?groupname=groupname", "rel": "self" }, "attribute": [] } } ] }
POST

Add direct child group membership

Adds a direct child group membership

Request

Query parameters

groupname

string

Required

Request bodyapplication/json application/xml

the child group

active

boolean

attributes

MultiValuedAttributeEntityList

description

string

expanded

boolean

link

Link

name

string

type

string

Responses

returned if the group was found

POST/rest/usermanagement/1/group/child-group/direct
1 2 3 4 5 6 7 8 9 10 11 12 curl --request POST \ --url 'http://{baseurl}/rest/rest/usermanagement/1/group/child-group/direct?groupname={groupname}' \ --header 'Content-Type: application/json' \ --data '{ "link": null, "name": "groupname", "description": null, "type": null, "active": null, "attributes": null, "expanded": true }'
DEL

Delete child group membership

Deletes a child group membership

Request

Query parameters

groupname

string

Required
child-groupname

string

Required

Responses

returned if the child group membership is deleted

DEL/rest/usermanagement/1/group/child-group/direct
1 2 curl --request DELETE \ --url 'http://{baseurl}/rest/rest/usermanagement/1/group/child-group/direct?groupname={groupname}&child-groupname={child-groupname}'
GET

Get nested children of group

Retrieves nested children of the specified group or a single nested child of that group with the specified name

Request

Query parameters

groupname

string

Required
child-groupname

string

start-index

integer

max-results

integer

Responses

returned if the group was found

application/json application/xml

any

GET/rest/usermanagement/1/group/child-group/nested
1 2 3 curl --request GET \ --url 'http://{baseurl}/rest/rest/usermanagement/1/group/child-group/nested?groupname={groupname}' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 { "group": [ { "link": { "href": "link_to_group", "rel": "self" }, "name": "groupname", "description": "Group Description", "type": "GROUP", "active": true, "attributes": { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/group/attributes?groupname=groupname", "rel": "self" }, "attribute": [] } }, { "link": { "href": "link_to_group", "rel": "self" }, "name": "groupname", "description": "Group Description", "type": "GROUP", "active": true, "attributes": { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/group/attributes?groupname=groupname", "rel": "self" }, "attribute": [] } } ] }
GET

Get all memberships

Retrieves full details of all group memberships, with users and nested groups. This resource is optimised for streaming XML responses, and does not support JSON responses

Request

This request has no parameters.

Responses

returned if memberships are retrieved

GET/rest/usermanagement/1/group/membership
1 2 curl --request GET \ --url 'http://{baseurl}/rest/rest/usermanagement/1/group/membership'
GET

Get direct group parents

Retrieves the groups that are direct parents of the specified group or a direct parent group of the specified child group

Request

Query parameters

groupname

string

Required
child-groupname

string

start-index

integer

max-results

integer

Responses

returned if the group is found

application/json application/xml

any

GET/rest/usermanagement/1/group/parent-group/direct
1 2 3 curl --request GET \ --url 'http://{baseurl}/rest/rest/usermanagement/1/group/parent-group/direct?groupname={groupname}' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 { "group": [ { "link": { "href": "link_to_group", "rel": "self" }, "name": "groupname", "description": "Group Description", "type": "GROUP", "active": true, "attributes": { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/group/attributes?groupname=groupname", "rel": "self" }, "attribute": [] } }, { "link": { "href": "link_to_group", "rel": "self" }, "name": "groupname", "description": "Group Description", "type": "GROUP", "active": true, "attributes": { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/group/attributes?groupname=groupname", "rel": "self" }, "attribute": [] } } ] }
POST

Add direct parent group membership

Adds a direct parent group membership

Request

Query parameters

groupname

string

Request bodyapplication/json application/xml

the user to add to the group

active

boolean

attributes

MultiValuedAttributeEntityList

description

string

expanded

boolean

link

Link

name

string

type

string

Responses

returned if the parent group membership is successfully added

POST/rest/usermanagement/1/group/parent-group/direct
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 curl --request POST \ --url 'http://{baseurl}/rest/rest/usermanagement/1/group/parent-group/direct' \ --header 'Content-Type: application/json' \ --data '{ "link": null, "name": "sampleuser", "firstName": null, "lastName": null, "displayName": null, "directoryId": null, "password": null, "encryptedPassword": null, "key": null, "createdDate": null, "updatedDate": null, "directoryName": null, "active": null, "attributes": null, "email": null, "expanded": true }'
GET

Get nested parent groups

Retrieves the groups that are nested parents of the specified group or a single nested parent of that group with the specified name

Request

Query parameters

groupname

string

Required
parent-groupname

string

start-index

integer

max-results

integer

Responses

returned if the group was found

application/json application/xml

any

GET/rest/usermanagement/1/group/parent-group/nested
1 2 3 curl --request GET \ --url 'http://{baseurl}/rest/rest/usermanagement/1/group/parent-group/nested?groupname={groupname}' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 { "group": [ { "link": { "href": "link_to_group", "rel": "self" }, "name": "groupname", "description": "Group Description", "type": "GROUP", "active": true, "attributes": { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/group/attributes?groupname=groupname", "rel": "self" }, "attribute": [] } }, { "link": { "href": "link_to_group", "rel": "self" }, "name": "groupname", "description": "Group Description", "type": "GROUP", "active": true, "attributes": { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/group/attributes?groupname=groupname", "rel": "self" }, "attribute": [] } } ] }
GET

Get direct members of group

Retrieves the users that are direct members of the specified group or a specified user who is a direct member of that group

Request

Query parameters

groupname

string

Required
username

string

start-index

integer

max-results

integer

Responses

returned if the group is found

application/json application/xml

any

GET/rest/usermanagement/1/group/user/direct
1 2 3 curl --request GET \ --url 'http://{baseurl}/rest/rest/usermanagement/1/group/user/direct?groupname={groupname}' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 { "user": [ { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/user?username=sampleuser", "rel": "self" }, "name": "sampleuser", "password": { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/user/password?username=sampleuser", "rel": "edit" } }, "key": "557057:927441f1-cc92-4030-b633-8a2bbdf7136e", "active": true, "attributes": { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/user/attributes?username=sampleuser&attributename=invalidPasswordAttempts&attributename=requiresPasswordChange", "rel": "self" }, "attribute": [ { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/user/attributes?username=sampleuser&attributename=invalidPasswordAttempts", "rel": "self" }, "name": "invalidPasswordAttempts", "values": [ "0" ] }, { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/user/attributes?username=sampleuser&attributename=invalidPasswordAttempts&attributename=requiresPasswordChange", "rel": "self" }, "name": "requiresPasswordChange", "values": [ "false" ] } ] }, "first-name": "Sample", "last-name": "User", "display-name": "Sample User", "email": "sample@user.cool" }, { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/user?username=sampleuser", "rel": "self" }, "name": "sampleuser", "password": { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/user/password?username=sampleuser", "rel": "edit" } }, "key": "557057:927441f1-cc92-4030-b633-8a2bbdf7136e", "active": true, "attributes": { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/user/attributes?username=sampleuser&attributename=invalidPasswordAttempts&attributename=requiresPasswordChange", "rel": "self" }, "attribute": [ { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/user/attributes?username=sampleuser&attributename=invalidPasswordAttempts", "rel": "self" }, "name": "invalidPasswordAttempts", "values": [ "0" ] }, { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/user/attributes?username=sampleuser&attributename=invalidPasswordAttempts&attributename=requiresPasswordChange", "rel": "self" }, "name": "requiresPasswordChange", "values": [ "false" ] } ] }, "first-name": "Sample", "last-name": "User", "display-name": "Sample User", "email": "sample@user.cool" } ] }
POST

Add user group membership

Adds a user as a direct member of the specified group

Request

Query parameters

groupname

string

Required

Request bodyapplication/json application/xml

the user to add to the group

active

boolean

attributes

MultiValuedAttributeEntityList

createdDate

string

directoryId

integer

directoryName

string

displayName

string

email

string

encryptedPassword

PasswordEntity

expanded

boolean

firstName

string

Responses

returned if the user is successfully added as a member of the group

POST/rest/usermanagement/1/group/user/direct
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 curl --request POST \ --url 'http://{baseurl}/rest/rest/usermanagement/1/group/user/direct?groupname={groupname}' \ --header 'Content-Type: application/json' \ --data '{ "link": null, "name": "sampleuser", "firstName": null, "lastName": null, "displayName": null, "directoryId": null, "password": null, "encryptedPassword": null, "key": null, "createdDate": null, "updatedDate": null, "directoryName": null, "active": null, "attributes": null, "email": null, "expanded": true }'
DEL

Remove user group membership

Removes the user membership

Request

Query parameters

groupname

string

Required
username

string

Required

Responses

returned if the user membership is successfully deleted

DEL/rest/usermanagement/1/group/user/direct
1 2 curl --request DELETE \ --url 'http://{baseurl}/rest/rest/usermanagement/1/group/user/direct?groupname={groupname}&username={username}'
GET

Get nested group members

Retrieves the users that are nested members of the specified group or a single user who is a nested member of the specified group

Request

Query parameters

groupname

string

Required
username

string

start-index

integer

max-results

integer

Responses

returned if the group is found

application/json application/xml

any

GET/rest/usermanagement/1/group/user/nested
1 2 3 curl --request GET \ --url 'http://{baseurl}/rest/rest/usermanagement/1/group/user/nested?groupname={groupname}' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 { "user": [ { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/user?username=sampleuser", "rel": "self" }, "name": "sampleuser", "password": { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/user/password?username=sampleuser", "rel": "edit" } }, "key": "557057:927441f1-cc92-4030-b633-8a2bbdf7136e", "active": true, "attributes": { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/user/attributes?username=sampleuser&attributename=invalidPasswordAttempts&attributename=requiresPasswordChange", "rel": "self" }, "attribute": [ { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/user/attributes?username=sampleuser&attributename=invalidPasswordAttempts", "rel": "self" }, "name": "invalidPasswordAttempts", "values": [ "0" ] }, { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/user/attributes?username=sampleuser&attributename=invalidPasswordAttempts&attributename=requiresPasswordChange", "rel": "self" }, "name": "requiresPasswordChange", "values": [ "false" ] } ] }, "first-name": "Sample", "last-name": "User", "display-name": "Sample User", "email": "sample@user.cool" }, { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/user?username=sampleuser", "rel": "self" }, "name": "sampleuser", "password": { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/user/password?username=sampleuser", "rel": "edit" } }, "key": "557057:927441f1-cc92-4030-b633-8a2bbdf7136e", "active": true, "attributes": { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/user/attributes?username=sampleuser&attributename=invalidPasswordAttempts&attributename=requiresPasswordChange", "rel": "self" }, "attribute": [ { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/user/attributes?username=sampleuser&attributename=invalidPasswordAttempts", "rel": "self" }, "name": "invalidPasswordAttempts", "values": [ "0" ] }, { "link": { "href": "https://crowdserver/crowd/rest/usermanagement/1/user/attributes?username=sampleuser&attributename=invalidPasswordAttempts&attributename=requiresPasswordChange", "rel": "self" }, "name": "requiresPasswordChange", "values": [ "false" ] } ] }, "first-name": "Sample", "last-name": "User", "display-name": "Sample User", "email": "sample@user.cool" } ] }

Rate this page: