Groups

Like users, groups have a simplified interface.

GETs (Reading Data)

Resource Description

/groups

Get a list of groups.

/groups/{groupname}

Get a specific group, given a group name.

/groups/{groupname}/users

Get the users for a group, given a group name.

/groups/{groupname}/categories

Get the categories associated with a group, given a group name.

POSTs (Adding Data)

Resource Description

/groups

Add a new group.

PUTs (Modifying Data)

Resource Description

/groups/{groupname}

Update the metadata of a group (for example, change the comments field).

/groups/{groupname}/users/{username}

Add a user to the group, given a group name and username.

/groups/{groupname}/categories/{categoryname}

Associate a category with the group, given a group name and category name.

DELETEs (Removing Data)

Resource Description

/groups/{groupname}

Delete a group.

/groups/{groupname}/users/{username}

Remove a user from the group.

/groups/{groupname}/categories/{categoryname}

Disassociate a category from a group, given a group name and category name.