Review Board 2.0 Documentation

Need help? Talk to us today about a support contract!

Jump to >

This documentation covers Review Board 2.0. You can see the latest Review Board documentation or all other versions.

Change Resource

Provides information on a change made to a public review request.

A change includes, optionally, text entered by the user describing the change, and also includes a list of fields that were changed on the review request.

The list of fields changed are in fields_changed. The keys are the names of the fields, and the values are details on that particular change to the field.

Details

Name change
URI /api/review-requests/{review_request_id}/changes/{change_id}/
HTTP Methods
  • GET - Returns the information on a change to a review request.
Parent Resource Change List Resource
Child Resources None
Anonymous Access Yes, if anonymous site access is enabled

Fields

fields_changedDictionary

The fields that were changed. Each key is the name of a changed field, and each value is a dictionary of details on that change.

For summary, description, testing_done and branch fields, the following detail keys will be available:

  • old: The old value of the field.
  • new: The new value of the field.

For diff fields:

  • added: The diff that was added.

For bugs_closed fields:

  • old: A list of old bugs.
  • new: A list of new bugs.
  • removed: A list of bugs that were removed, if any.
  • added: A list of bugs that were added, if any.

For file_attachments, screenshots, target_people and target_groups fields:

  • old: A list of old items.
  • new: A list of new items.
  • removed: A list of items that were removed, if any.
  • added: A list of items that were added, if any.

For screenshot_captions and file_captions fields:

  • old: The old caption.
  • new: The new caption.
  • screenshot: The screenshot that was updated.
idInteger The numeric ID of the change description.
textRich Text The description of the change written by the submitter.
text_typeOne of plain, markdown, html The mode for the text field.
timestampString The date and time that the change was made (in YYYY-MM-DD HH:MM:SS format).

HTTP GET

Returns the information on a change to a review request.

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

Examples

application/vnd.reviewboard.org.review-request-change+json

$ curl http://reviews.example.com/api/review-requests/8/changes/2/ -H "Accept: application/json"

Vary: Accept, Cookie
ETag: 28bfa0f744f8e767cba3de1c2369545fe6f111c5
Content-Type: application/vnd.reviewboard.org.review-request-change+json
X-Content-Type-Options: nosniff

{
  "change": {
    "fields_changed": {
      "diff": {
        "added": {
          "base_commit_id": null, 
          "basedir": "", 
          "extra_data": {}, 
          "id": 11, 
          "links": {
            "files": {
              "href": "http://reviews.example.com/api/review-requests/8/diffs/3/files/", 
              "method": "GET"
            }, 
            "repository": {
              "href": "http://reviews.example.com/api/repositories/1/", 
              "method": "GET", 
              "title": "Review Board SVN"
            }, 
            "self": {
              "href": "http://reviews.example.com/api/review-requests/8/diffs/3/", 
              "method": "GET"
            }, 
            "update": {
              "href": "http://reviews.example.com/api/review-requests/8/diffs/3/", 
              "method": "PUT"
            }
          }, 
          "name": "diff", 
          "revision": 3, 
          "timestamp": "2009-02-25T21:39:42Z"
        }
      }
    }, 
    "id": 2, 
    "links": {
      "self": {
        "href": "http://reviews.example.com/api/review-requests/8/changes/2/", 
        "method": "GET"
      }
    }, 
    "text": "Added a diff containing a new file.", 
    "text_type": "plain", 
    "timestamp": "2013-08-07T22:32:13Z"
  }, 
  "stat": "ok"
}