We can host Review Board for you! Give us a try at RBCommons.

This documentation covers the in-development release of Review Board. You can see the latest stable docs or all previous versions.

Review Group Resource

Name group
URI /api/groups/{group_name}/
Description

Provides information on review groups.

Review groups are groups of users that can be listed as an intended reviewer on a review request.

Review groups cannot be created or modified through the API.
HTTP Methods
  • DELETE - Deletes a review group.
  • GET - Retrieve information on a review group.
Parent Resource Review Group List Resource
Child Resources
Anonymous Access Yes, if anonymous site access is enabled

Fields

Field Type Description
display_name String The human-readable name of the group, sometimes used as a short description.
id Integer The numeric ID of the review group.
invite_only Boolean Whether or not the group is invite-only. An invite-only group is only accessible by members of the group.
mailing_list String The e-mail address that all posts on a review group are sent to.
name String The short name of the group, used in the reviewer list and the Dashboard.
url String The URL to the user’s page on the site. This is deprecated and will be removed in a future version.
visible Boolean Whether or not the group is visible to users who are not members. This does not prevent users from accessing the group if they know it, though.

HTTP DELETE

Deletes a review group.

HTTP GET

Retrieve information on a review group.

Some basic information on the review group is provided, including the name, description, and mailing list (if any) that e-mails to the group are sent to.

The group links to the list of users that are members of the group.

Examples

application/json

{
  "group": {
    "display_name": "Dev Group", 
    "id": 1, 
    "invite_only": false, 
    "links": {
      "delete": {
        "href": "http://reviews.example.com/api/groups/devgroup/", 
        "method": "DELETE"
      }, 
      "self": {
        "href": "http://reviews.example.com/api/groups/devgroup/", 
        "method": "GET"
      }, 
      "users": {
        "href": "http://reviews.example.com/api/groups/devgroup/users/", 
        "method": "GET"
      }
    }, 
    "mailing_list": "devgroup@example.com", 
    "name": "devgroup", 
    "url": "/groups/devgroup/", 
    "visible": true
  }, 
  "stat": "ok"
}

application/xml

<?xml version="1.0" encoding="utf-8"?>
<rsp>
 <stat>ok</stat>
 <group>
  <display_name>Dev Group</display_name>
  <name>devgroup</name>
  <links>
   <self>
    <href>http://reviews.example.com/api/groups/devgroup/</href>
    <method>GET</method>
   </self>
   <users>
    <href>http://reviews.example.com/api/groups/devgroup/users/</href>
    <method>GET</method>
   </users>
   <delete>
    <href>http://reviews.example.com/api/groups/devgroup/</href>
    <method>DELETE</method>
   </delete>
  </links>
  <url>/groups/devgroup/</url>
  <visible>1</visible>
  <invite_only>0</invite_only>
  <id>1</id>
  <mailing_list>devgroup@example.com</mailing_list>
 </group>
</rsp>

application/vnd.reviewboard.org.review-group+json

{"stat": "ok", "group": {"display_name": "Dev Group", "name": "devgroup", "links": {"self": {"href": "http://reviews.example.com/api/groups/devgroup/", "method": "GET"}, "users": {"href": "http://reviews.example.com/api/groups/devgroup/users/", "method": "GET"}, "delete": {"href": "http://reviews.example.com/api/groups/devgroup/", "method": "DELETE"}}, "url": "/groups/devgroup/", "visible": true, "invite_only": false, "id": 1, "mailing_list": "devgroup@example.com"}}

application/vnd.reviewboard.org.review-group+xml

<?xml version="1.0" encoding="utf-8"?>
<rsp>
 <stat>ok</stat>
 <group>
  <display_name>Dev Group</display_name>
  <name>devgroup</name>
  <links>
   <self>
    <href>http://reviews.example.com/api/groups/devgroup/</href>
    <method>GET</method>
   </self>
   <users>
    <href>http://reviews.example.com/api/groups/devgroup/users/</href>
    <method>GET</method>
   </users>
   <delete>
    <href>http://reviews.example.com/api/groups/devgroup/</href>
    <method>DELETE</method>
   </delete>
  </links>
  <url>/groups/devgroup/</url>
  <visible>1</visible>
  <invite_only>0</invite_only>
  <id>1</id>
  <mailing_list>devgroup@example.com</mailing_list>
 </group>
</rsp>