Review Reply Resource¶

Provides information on a reply to a review.

A reply is much like a review, but is always tied to exactly one parent review. Every comment associated with a reply is also tied to a parent comment.

Details¶

Name	`reply`
URI	`/api/review-requests/{review_request_id}/reviews/{review_id}/replies/{reply_id}/`
Token Policy ID	`review_reply`
HTTP Methods	DELETE - Deletes the draft review. GET - Returns information on a particular reply. PUT - Updates a reply.
Parent Resource	Review Reply List Resource
Child Resources	Review Reply Diff Comment List Resource Review Reply File Attachment Comment List Resource Review Reply General Comment List Resource Review Reply Screenshot Comment List Resource

Fields¶

body_bottomRich Text	The response to the review content below the comments.
body_bottom_text_typeOne of `plain`, `markdown`, `html`	The current or forced text type for the body_bottom field. Added in 2.0.12
body_topRich Text	The response to the review content above the comments.
body_top_text_typeOne of `plain`, `markdown`, `html`	The current or forced text type for the body_top field. Added in 2.0.12
extra_dataDictionary	Extra data as part of the reply. This can be set by the API or extensions. Added in 2.0
idInteger	The numeric ID of the reply.
publicBoolean	Whether or not the reply is currently visible to other users.
text_typeOne of `plain`, `markdown`, `html`	Deprecated Formerly responsible for indicating the text type for text fields. Replaced by body_top_text_type and body_bottom_text_type in 2.0.12. Added in 2.0 Deprecated in 2.0.12
timestamp ISO 8601 Date/Time	The date and time that the reply was posted.
userUser Resource	The user who wrote the reply.

Links¶

Name	Method	Resource
delete	DELETE	Review Reply Resource
diff_comments	GET	Review Reply Diff Comment List Resource
file_attachment_comments	GET	Review Reply File Attachment Comment List Resource
general_comments	GET	Review Reply General Comment List Resource
screenshot_comments	GET	Review Reply Screenshot Comment List Resource
self	GET	Review Reply Resource
update	PUT	Review Reply Resource

HTTP DELETE¶

Deletes the draft review.

This only works for draft reviews, not public reviews. It will delete the review and all comments on it. This cannot be undone.

Only the user who owns the draft can delete it.

Upon deletion, this will return HTTP 204 No Content.

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.

HTTP GET¶

Returns information on a particular reply.

If the reply is not public, then the client’s logged in user must either be the owner of the reply. Otherwise, an error will be returned.

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.

HTTP PUT¶

Updates a reply.

This updates the fields of a draft reply. Published replies cannot be updated.

Only the owner of a reply can make changes. One or more fields can be updated at once.

The only special field is public, which, if set to true, will publish the reply. The reply will then be made publicly visible. Once public, the reply cannot be modified or made private again.

Extra data can be stored later lookup. See Storing/Accessing Extra Data for more information.

Request Parameters¶

body_bottomRich Text	The response to the review content below the comments.
body_bottom_text_typeOne of `plain`, `markdown`	The text type used for the body_bottom field. Added in 2.0.12
body_topRich Text	The response to the review content above the comments.
body_top_text_typeOne of `plain`, `markdown`	The text type used for the body_top field. Added in 2.0.12
force_text_typeOne of `plain`, `markdown`, `html`	The text type, if any, to force for returned text fields. The contents will be converted to the requested type in the payload, but will not be saved as that type. Added in 2.0.9
publicBoolean	Whether or not to make the reply public. If a reply is public, it cannot be made private again.
text_typeOne of `plain`, `markdown`	Deprecated The mode for the body_top and body_bottom text fields. This is deprecated. Please use body_top_text_type and body_bottom_text_type instead. Added in 2.0 Deprecated in 2.0.12
trivialBoolean	If true, the review does not send an email. Added in 2.5

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
105 - Invalid Form DataHTTP 400 - Bad Request	One or more fields had errors
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.review-reply+json¶

$ curl https://reviews.example.com/api/review-requests/8/reviews/8/replies/10/ -H "Accept: application/json"

HTTP 200 OK
Content-Length: 1262
Content-Type: application/vnd.reviewboard.org.review-reply+json
ETag: 1cba4b676edbb883bb1ffcac12f647aedf5768c5
Vary: Accept, Cookie
X-Content-Type-Options: nosniff

{
  "reply": {
    "body_bottom": "",
    "body_bottom_text_type": "plain",
    "body_top": "Excellent point.",
    "body_top_text_type": "plain",
    "extra_data": {},
    "id": 10,
    "links": {
      "delete": {
        "href": "https://reviews.example.com/api/review-requests/8/reviews/8/replies/10/",
        "method": "DELETE"
      },
      "diff_comments": {
        "href": "https://reviews.example.com/api/review-requests/8/reviews/8/replies/10/diff-comments/",
        "method": "GET"
      },
      "file_attachment_comments": {
        "href": "https://reviews.example.com/api/review-requests/8/reviews/8/replies/10/file-attachment-comments/",
        "method": "GET"
      },
      "general_comments": {
        "href": "https://reviews.example.com/api/review-requests/8/reviews/8/replies/10/general-comments/",
        "method": "GET"
      },
      "screenshot_comments": {
        "href": "https://reviews.example.com/api/review-requests/8/reviews/8/replies/10/screenshot-comments/",
        "method": "GET"
      },
      "self": {
        "href": "https://reviews.example.com/api/review-requests/8/reviews/8/replies/10/",
        "method": "GET"
      },
      "update": {
        "href": "https://reviews.example.com/api/review-requests/8/reviews/8/replies/10/",
        "method": "PUT"
      },
      "user": {
        "href": "https://reviews.example.com/api/users/admin/",
        "method": "GET",
        "title": "admin"
      }
    },
    "public": true,
    "text_type": null,
    "timestamp": "2010-08-28T02:26:47Z"
  },
  "stat": "ok"
}