Jump to >

Root List Resource

Name root
URI /api/
Description

Links to all the main resources, including URI templates to resources anywhere in the tree.

This should be used as a starting point for any clients that need to access any resources in the API. By browsing through the resource tree instead of hard-coding paths, your client can remain compatible with any changes in the resource URI scheme.

HTTP Methods
  • GET - Handles HTTP GETs to list resources.
Parent Resource None.
Child Resources
Anonymous Access Yes

HTTP GET

Handles HTTP GETs to list resources.

By default, this will query for a list of objects and return the list in a serialized form.

Request Parameters

Field Type Description
max-results (optional) Integer The maximum number of results to return in this list. By default, this is 25.
start (optional) Integer The 0-based index of the first result in the list. The start index is usually the previous start index plus the number of previous results. By default, this is 0.

Examples

application/vnd.reviewboard.org.root+json

{
  "links": {
    "default_reviewers": {
      "href": "http://reviews.example.com/api/default-reviewers/", 
      "method": "GET"
    }, 
    "groups": {
      "href": "http://reviews.example.com/api/groups/", 
      "method": "GET"
    }, 
    "hosting_service_accounts": {
      "href": "http://reviews.example.com/api/hosting-service-accounts/", 
      "method": "GET"
    }, 
    "info": {
      "href": "http://reviews.example.com/api/info/", 
      "method": "GET"
    }, 
    "repositories": {
      "href": "http://reviews.example.com/api/repositories/", 
      "method": "GET"
    }, 
    "review_requests": {
      "href": "http://reviews.example.com/api/review-requests/", 
      "method": "GET"
    }, 
    "search": {
      "href": "http://reviews.example.com/api/search/", 
      "method": "GET"
    }, 
    "self": {
      "href": "http://reviews.example.com/api/", 
      "method": "GET"
    }, 
    "session": {
      "href": "http://reviews.example.com/api/session/", 
      "method": "GET"
    }, 
    "users": {
      "href": "http://reviews.example.com/api/users/", 
      "method": "GET"
    }
  }, 
  "stat": "ok", 
  "uri_templates": {
    "change": "http://reviews.example.com/api/review-requests/{review_request_id}/changes/{change_id}/", 
    "changes": "http://reviews.example.com/api/review-requests/{review_request_id}/changes/", 
    "default_reviewer": "http://reviews.example.com/api/default-reviewers/{default_reviewer_id}/", 
    "default_reviewers": "http://reviews.example.com/api/default-reviewers/", 
    "diff": "http://reviews.example.com/api/review-requests/{review_request_id}/diffs/{diff_revision}/", 
    "diff_comment": "http://reviews.example.com/api/review-requests/{review_request_id}/reviews/{review_id}/replies/{reply_id}/diff-comments/{comment_id}/", 
    "diff_comments": "http://reviews.example.com/api/review-requests/{review_request_id}/reviews/{review_id}/replies/{reply_id}/diff-comments/", 
    "diffs": "http://reviews.example.com/api/review-requests/{review_request_id}/diffs/", 
    "draft": "http://reviews.example.com/api/review-requests/{review_request_id}/draft/", 
    "file": "http://reviews.example.com/api/review-requests/{review_request_id}/diffs/{diff_revision}/files/{filediff_id}/", 
    "file_attachment": "http://reviews.example.com/api/review-requests/{review_request_id}/file-attachments/{file_attachment_id}/", 
    "file_attachment_comment": "http://reviews.example.com/api/review-requests/{review_request_id}/reviews/{review_id}/file-attachment-comments/{comment_id}/", 
    "file_attachment_comments": "http://reviews.example.com/api/review-requests/{review_request_id}/file-attachments/{file_attachment_id}/file-attachment-comments/", 
    "file_attachments": "http://reviews.example.com/api/review-requests/{review_request_id}/file-attachments/", 
    "files": "http://reviews.example.com/api/review-requests/{review_request_id}/diffs/{diff_revision}/files/", 
    "group": "http://reviews.example.com/api/groups/{group_name}/", 
    "groups": "http://reviews.example.com/api/groups/", 
    "hosting_service_account": "http://reviews.example.com/api/hosting-service-accounts/{account_id}/", 
    "hosting_service_accounts": "http://reviews.example.com/api/hosting-service-accounts/", 
    "info": "http://reviews.example.com/api/info/", 
    "last_update": "http://reviews.example.com/api/review-requests/{review_request_id}/last-update/", 
    "replies": "http://reviews.example.com/api/review-requests/{review_request_id}/reviews/{review_id}/replies/", 
    "reply": "http://reviews.example.com/api/review-requests/{review_request_id}/reviews/{review_id}/replies/{reply_id}/", 
    "reply_draft": "http://reviews.example.com/api/review-requests/{review_request_id}/reviews/{review_id}/replies/draft/", 
    "repositories": "http://reviews.example.com/api/repositories/", 
    "repository": "http://reviews.example.com/api/repositories/{repository_id}/", 
    "review": "http://reviews.example.com/api/review-requests/{review_request_id}/reviews/{review_id}/", 
    "review_draft": "http://reviews.example.com/api/review-requests/{review_request_id}/reviews/draft/", 
    "review_request": "http://reviews.example.com/api/review-requests/{review_request_id}/", 
    "review_requests": "http://reviews.example.com/api/review-requests/", 
    "reviews": "http://reviews.example.com/api/review-requests/{review_request_id}/reviews/", 
    "root": "http://reviews.example.com/api/", 
    "screenshot": "http://reviews.example.com/api/review-requests/{review_request_id}/screenshots/{screenshot_id}/", 
    "screenshot_comment": "http://reviews.example.com/api/review-requests/{review_request_id}/reviews/{review_id}/screenshot-comments/{comment_id}/", 
    "screenshot_comments": "http://reviews.example.com/api/review-requests/{review_request_id}/screenshots/{screenshot_id}/screenshot-comments/", 
    "screenshots": "http://reviews.example.com/api/review-requests/{review_request_id}/screenshots/", 
    "search": "http://reviews.example.com/api/search/{username}/", 
    "session": "http://reviews.example.com/api/session/", 
    "user": "http://reviews.example.com/api/users/{username}/", 
    "users": "http://reviews.example.com/api/users/", 
    "watched": "http://reviews.example.com/api/users/{username}/watched/", 
    "watched_review_group": "http://reviews.example.com/api/users/{username}/watched/review-groups/{watched_obj_id}/", 
    "watched_review_groups": "http://reviews.example.com/api/users/{username}/watched/review-groups/", 
    "watched_review_request": "http://reviews.example.com/api/users/{username}/watched/review-requests/{watched_obj_id}/", 
    "watched_review_requests": "http://reviews.example.com/api/users/{username}/watched/review-requests/"
  }
}

application/vnd.reviewboard.org.root+xml

<?xml version="1.0" encoding="utf-8"?>
<rsp>
 <stat>ok</stat>
 <uri_templates>
  <diff_comments>http://reviews.example.com/api/review-requests/{review_request_id}/reviews/{review_id}/replies/{reply_id}/diff-comments/</diff_comments>
  <replies>http://reviews.example.com/api/review-requests/{review_request_id}/reviews/{review_id}/replies/</replies>
  <watched_review_groups>http://reviews.example.com/api/users/{username}/watched/review-groups/</watched_review_groups>
  <session>http://reviews.example.com/api/session/</session>
  <file_attachments>http://reviews.example.com/api/review-requests/{review_request_id}/file-attachments/</file_attachments>
  <file>http://reviews.example.com/api/review-requests/{review_request_id}/diffs/{diff_revision}/files/{filediff_id}/</file>
  <diff>http://reviews.example.com/api/review-requests/{review_request_id}/diffs/{diff_revision}/</diff>
  <watched>http://reviews.example.com/api/users/{username}/watched/</watched>
  <screenshots>http://reviews.example.com/api/review-requests/{review_request_id}/screenshots/</screenshots>
  <watched_review_request>http://reviews.example.com/api/users/{username}/watched/review-requests/{watched_obj_id}/</watched_review_request>
  <group>http://reviews.example.com/api/groups/{group_name}/</group>
  <screenshot>http://reviews.example.com/api/review-requests/{review_request_id}/screenshots/{screenshot_id}/</screenshot>
  <review>http://reviews.example.com/api/review-requests/{review_request_id}/reviews/{review_id}/</review>
  <watched_review_group>http://reviews.example.com/api/users/{username}/watched/review-groups/{watched_obj_id}/</watched_review_group>
  <last_update>http://reviews.example.com/api/review-requests/{review_request_id}/last-update/</last_update>
  <diff_comment>http://reviews.example.com/api/review-requests/{review_request_id}/reviews/{review_id}/replies/{reply_id}/diff-comments/{comment_id}/</diff_comment>
  <draft>http://reviews.example.com/api/review-requests/{review_request_id}/draft/</draft>
  <file_attachment>http://reviews.example.com/api/review-requests/{review_request_id}/file-attachments/{file_attachment_id}/</file_attachment>
  <reply>http://reviews.example.com/api/review-requests/{review_request_id}/reviews/{review_id}/replies/{reply_id}/</reply>
  <review_request>http://reviews.example.com/api/review-requests/{review_request_id}/</review_request>
  <files>http://reviews.example.com/api/review-requests/{review_request_id}/diffs/{diff_revision}/files/</files>
  <review_draft>http://reviews.example.com/api/review-requests/{review_request_id}/reviews/draft/</review_draft>
  <users>http://reviews.example.com/api/users/</users>
  <repository>http://reviews.example.com/api/repositories/{repository_id}/</repository>
  <file_attachment_comments>http://reviews.example.com/api/review-requests/{review_request_id}/file-attachments/{file_attachment_id}/file-attachment-comments/</file_attachment_comments>
  <screenshot_comments>http://reviews.example.com/api/review-requests/{review_request_id}/screenshots/{screenshot_id}/screenshot-comments/</screenshot_comments>
  <hosting_service_accounts>http://reviews.example.com/api/hosting-service-accounts/</hosting_service_accounts>
  <groups>http://reviews.example.com/api/groups/</groups>
  <watched_review_requests>http://reviews.example.com/api/users/{username}/watched/review-requests/</watched_review_requests>
  <change>http://reviews.example.com/api/review-requests/{review_request_id}/changes/{change_id}/</change>
  <info>http://reviews.example.com/api/info/</info>
  <diffs>http://reviews.example.com/api/review-requests/{review_request_id}/diffs/</diffs>
  <search>http://reviews.example.com/api/search/{username}/</search>
  <default_reviewer>http://reviews.example.com/api/default-reviewers/{default_reviewer_id}/</default_reviewer>
  <root>http://reviews.example.com/api/</root>
  <review_requests>http://reviews.example.com/api/review-requests/</review_requests>
  <file_attachment_comment>http://reviews.example.com/api/review-requests/{review_request_id}/reviews/{review_id}/file-attachment-comments/{comment_id}/</file_attachment_comment>
  <repositories>http://reviews.example.com/api/repositories/</repositories>
  <reviews>http://reviews.example.com/api/review-requests/{review_request_id}/reviews/</reviews>
  <reply_draft>http://reviews.example.com/api/review-requests/{review_request_id}/reviews/{review_id}/replies/draft/</reply_draft>
  <screenshot_comment>http://reviews.example.com/api/review-requests/{review_request_id}/reviews/{review_id}/screenshot-comments/{comment_id}/</screenshot_comment>
  <default_reviewers>http://reviews.example.com/api/default-reviewers/</default_reviewers>
  <changes>http://reviews.example.com/api/review-requests/{review_request_id}/changes/</changes>
  <hosting_service_account>http://reviews.example.com/api/hosting-service-accounts/{account_id}/</hosting_service_account>
  <user>http://reviews.example.com/api/users/{username}/</user>
 </uri_templates>
 <links>
  <info>
   <href>http://reviews.example.com/api/info/</href>
   <method>GET</method>
  </info>
  <search>
   <href>http://reviews.example.com/api/search/</href>
   <method>GET</method>
  </search>
  <users>
   <href>http://reviews.example.com/api/users/</href>
   <method>GET</method>
  </users>
  <review_requests>
   <href>http://reviews.example.com/api/review-requests/</href>
   <method>GET</method>
  </review_requests>
  <repositories>
   <href>http://reviews.example.com/api/repositories/</href>
   <method>GET</method>
  </repositories>
  <session>
   <href>http://reviews.example.com/api/session/</href>
   <method>GET</method>
  </session>
  <hosting_service_accounts>
   <href>http://reviews.example.com/api/hosting-service-accounts/</href>
   <method>GET</method>
  </hosting_service_accounts>
  <groups>
   <href>http://reviews.example.com/api/groups/</href>
   <method>GET</method>
  </groups>
  <default_reviewers>
   <href>http://reviews.example.com/api/default-reviewers/</href>
   <method>GET</method>
  </default_reviewers>
  <self>
   <href>http://reviews.example.com/api/</href>
   <method>GET</method>
  </self>
 </links>
</rsp>