Actions
Rest Groups » History » Revision 4
« Previous |
Revision 4/10
(diff)
| Next »
Jean-Philippe Lang, 2012-06-03 15:24
Groups¶
- Table of contents
- Groups
/groups.:format¶
GET¶
Returns the list of groups.
Example:
GET /groups.xml
Response:
<groups type="array"> <group> <id>53</id> <name>Managers</name> </group> <group> <id>55</id> <name>Developers</name> </group> </groups>
POST¶
Creates a group.
Parameters:
group
(required): a hash of the group attributes, including:name
(required): the group nameuser_ids
: ids of the group users (an empty group is created if not provided)
Example:
POST /groups.xml <group> <name>Developers</name> <user_ids> <user_id>3</user_id> <user_id>5</user_id> </user_ids> </group>
Response:
201 Created
: group was created422 Unprocessable Entity
: group was not created due to validation failures (response body contains the error messages)
/groups/:id.:format¶
GET¶
Returns details and members for a group.
Parameters:
include
(optional): a coma separated list of associations to include in the response:memberships
Example:
GET /groups/20.xml
Response:
<group> <id>20</id> <name>Developers</name> <users type="array"> <user id="5" name="John Smith"/> <user id="8" name="Dave Loper"/> </users> </group>
PUT¶
Updates an existing group.
DELETE¶
Deletes an existing group.
/groups/:id/users.:format¶
POST¶
Adds an existing user to a group.
Parameters:
user_id
(required): id of the user to add to the group.
Example:
POST /groups/10/users.xml <user_id>5</user_id>
Response:
200 OK
: user was added to the group
/groups/:id/users/:user_id.:format¶
DELETE¶
Removes a user from a group.
Example:
DELETE /groups/10/users/5.xml
Response:
200 OK
: user was removed to the group
Updated by Jean-Philippe Lang over 12 years ago · 4 revisions