Root List Resource¶

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.

This also contains information on the server and the capabilities of the API. This information was formerly provided only by the Server Info resource, but has been moved here as a convenience to clients.

Details¶

Name	`root`
URI	`/api/`
Token Policy ID	`root`
HTTP Methods	GET - Retrieves the list of top-level resources and templates.
Parent Resource	None.
Child Resources	Default Reviewer List Resource Extension List Resource Hosting Service Account List Resource Hosting Service List Resource OAuth2 Applications List Resource OAuth2 Tokens List Resource Repository List Resource Review Group List Resource Review Request List Resource Search Resource Server Info Resource Session Resource User List Resource Validation List Resource WebHook List Resource
Anonymous Access	Yes, if anonymous site access is enabled

Links¶

Name	Method	Resource
default_reviewers	GET	Default Reviewer List Resource
extensions	GET	Extension List Resource
groups	GET	Review Group List Resource
hosting_service_accounts	GET	Hosting Service Account List Resource
hosting_services	GET	Hosting Service List Resource
info	GET	Server Info Resource
oauth_apps	GET	OAuth2 Applications List Resource
oauth_tokens	GET	OAuth2 Tokens List Resource
repositories	GET	Repository List Resource
review_requests	GET	Review Request List Resource
search	GET	Search Resource
self	GET	Root List Resource
session	GET	Session Resource
users	GET	User List Resource
validation	GET	Validation List Resource
webhooks	GET	WebHook List Resource

HTTP GET¶

Retrieves the list of top-level resources and templates.

Errors¶

100 - Does Not ExistHTTP 404 - Not Found	Object does not exist
101 - Permission DeniedHTTP 403 - Forbidden	You don’t have permission for this
103 - Not Logged InHTTP 401 - Unauthorized	You are not logged in
112 - OAuth2 Missing Scope ErrorHTTP 403 - Forbidden	Your OAuth2 token lacks the necessary scopes for this request.
113 - OAuth2 Access Denied ErrorHTTP 403 - Forbidden	OAuth2 token access for this resource is prohibited.

Examples¶

application/vnd.reviewboard.org.root+json¶

$ curl http://reviews.example.com/api/ -H "Accept: application/json"

Vary: Accept, Cookie
ETag: a38c5f17280e6708aed33c3582adb89abbb57f01
Content-Type: application/vnd.reviewboard.org.root+json
X-Content-Type-Options: nosniff

{
  "capabilities": {
    "diffs": {
      "base_commit_ids": true, 
      "moved_files": true, 
      "validation": {
        "base_commit_ids": true
      }
    }, 
    "extra_data": {
      "json_patching": true
    }, 
    "review_requests": {
      "commit_ids": true, 
      "trivial_publish": true
    }, 
    "scmtools": {
      "git": {
        "empty_files": true, 
        "symlinks": true
      }, 
      "mercurial": {
        "empty_files": true
      }, 
      "perforce": {
        "empty_files": true, 
        "moved_files": true
      }, 
      "svn": {
        "empty_files": true
      }
    }, 
    "text": {
      "can_include_raw_values": true, 
      "markdown": true, 
      "per_field_text_types": true
    }
  }, 
  "links": {
    "default_reviewers": {
      "href": "http://reviews.example.com/api/default-reviewers/", 
      "method": "GET"
    }, 
    "extensions": {
      "href": "http://reviews.example.com/api/extensions/", 
      "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"
    }, 
    "hosting_services": {
      "href": "http://reviews.example.com/api/hosting-services/", 
      "method": "GET"
    }, 
    "info": {
      "href": "http://reviews.example.com/api/info/", 
      "method": "GET"
    }, 
    "oauth_apps": {
      "href": "http://reviews.example.com/api/oauth-apps/", 
      "method": "GET"
    }, 
    "oauth_tokens": {
      "href": "http://reviews.example.com/api/oauth-tokens/", 
      "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"
    }, 
    "validation": {
      "href": "http://reviews.example.com/api/validation/", 
      "method": "GET"
    }, 
    "webhooks": {
      "href": "http://reviews.example.com/api/webhooks/", 
      "method": "GET"
    }
  }, 
  "product": {
    "is_release": true, 
    "name": "Review Board", 
    "package_version": "3.0.25", 
    "version": "3.0.25"
  }, 
  "site": {
    "administrators": [
      {
        "email": "admin@example.com", 
        "name": "Example Admin"
      }
    ], 
    "time_zone": "UTC", 
    "url": "http://example.com/"
  }, 
  "stat": "ok", 
  "uri_templates": {
    "api_token": "http://reviews.example.com/api/users/{username}/api-tokens/{api_token_id}/", 
    "api_tokens": "http://reviews.example.com/api/users/{username}/api-tokens/", 
    "archived_review_request": "http://reviews.example.com/api/users/{username}/archived-review-requests/{review_request_id}/", 
    "archived_review_requests": "http://reviews.example.com/api/users/{username}/archived-review-requests/", 
    "branches": "http://reviews.example.com/api/repositories/{repository_id}/branches/", 
    "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/", 
    "commits": "http://reviews.example.com/api/repositories/{repository_id}/commits/", 
    "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/", 
    "diff_context": "http://reviews.example.com/api/review-requests/{review_request_id}/diff-context/", 
    "diff_file_attachment": "http://reviews.example.com/api/repositories/{repository_id}/diff-file-attachments/{file_attachment_id}/", 
    "diff_file_attachments": "http://reviews.example.com/api/repositories/{repository_id}/diff-file-attachments/", 
    "diff_validation": "http://reviews.example.com/api/validation/diffs/", 
    "diffs": "http://reviews.example.com/api/review-requests/{review_request_id}/diffs/", 
    "draft": "http://reviews.example.com/api/review-requests/{review_request_id}/draft/", 
    "extension": "http://reviews.example.com/api/extensions/{extension_name}/", 
    "extensions": "http://reviews.example.com/api/extensions/", 
    "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}/reviews/{review_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/", 
    "general_comment": "http://reviews.example.com/api/review-requests/{review_request_id}/reviews/{review_id}/general-comments/{comment_id}/", 
    "general_comments": "http://reviews.example.com/api/review-requests/{review_request_id}/reviews/{review_id}/general-comments/", 
    "group": "http://reviews.example.com/api/groups/{group_name}/", 
    "groups": "http://reviews.example.com/api/groups/", 
    "hosting_service": "http://reviews.example.com/api/hosting-services/{hosting_service_id}/", 
    "hosting_service_account": "http://reviews.example.com/api/hosting-service-accounts/{account_id}/", 
    "hosting_service_accounts": "http://reviews.example.com/api/hosting-service-accounts/", 
    "hosting_services": "http://reviews.example.com/api/hosting-services/", 
    "info": "http://reviews.example.com/api/info/", 
    "last_update": "http://reviews.example.com/api/review-requests/{review_request_id}/last-update/", 
    "muted_review_request": "http://reviews.example.com/api/users/{username}/muted-review-requests/{review_request_id}/", 
    "muted_review_requests": "http://reviews.example.com/api/users/{username}/muted-review-requests/", 
    "oauth_app": "http://reviews.example.com/api/oauth-apps/{app_id}/", 
    "oauth_apps": "http://reviews.example.com/api/oauth-apps/", 
    "oauth_token": "http://reviews.example.com/api/oauth-tokens/{oauth_token_id}/", 
    "oauth_tokens": "http://reviews.example.com/api/oauth-tokens/", 
    "original_file": "http://reviews.example.com/api/review-requests/{review_request_id}/diffs/{diff_revision}/files/{filediff_id}/original-file/", 
    "patched_file": "http://reviews.example.com/api/review-requests/{review_request_id}/diffs/{diff_revision}/files/{filediff_id}/patched-file/", 
    "remote_repositories": "http://reviews.example.com/api/hosting-service-accounts/{account_id}/remote-repositories/", 
    "remote_repository": "http://reviews.example.com/api/hosting-service-accounts/{account_id}/remote-repositories/{repository_id}/", 
    "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_group_user": "http://reviews.example.com/api/groups/{group_name}/users/{username}/", 
    "review_group_users": "http://reviews.example.com/api/groups/{group_name}/users/", 
    "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/", 
    "status_update": "http://reviews.example.com/api/review-requests/{review_request_id}/status-updates/{status_update_id}/", 
    "status_updates": "http://reviews.example.com/api/review-requests/{review_request_id}/status-updates/", 
    "user": "http://reviews.example.com/api/users/{username}/", 
    "user_file_attachment": "http://reviews.example.com/api/users/{username}/user-file-attachments/{file_attachment_id}/", 
    "user_file_attachments": "http://reviews.example.com/api/users/{username}/user-file-attachments/", 
    "users": "http://reviews.example.com/api/users/", 
    "validation": "http://reviews.example.com/api/validation/", 
    "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/", 
    "webhook": "http://reviews.example.com/api/webhooks/{webhook_id}/", 
    "webhooks": "http://reviews.example.com/api/webhooks/"
  }
}