| Table of Contents |
Get a List of Reviews
| Description | Get a list of reviews |
URL | /api/reviews |
| Method | GET |
Security | Requires User role on the project |
| Number or Results | Results are limited to 200 reviews, ordered by creation date (most recent to oldest) |
Examples
Get reviews whose ids are 47 and 48:
Get all open reviews on project org.codehaus.sonar:sonar:
Parameters
Parameter | Description | Required | Default value |
|---|---|---|---|
ids | List of review ids | No |
|
resources | Comma-separated list of resource ids or keys | No |
|
projects | Comma-separated list of root project ids or keys | No |
|
statuses | Comma-separated list of status | No |
|
resolutions | Comma-separated list of resolutions | No |
|
severities | Comma-separated list of severities | No |
|
authors | Comma-separated list of author login | No |
|
assignees | Comma-separated list of assignee login | No |
|
review_type | Type of review | No | VIOLATION |
output | Format of comments | No | PLAIN |
| format | Response format: xml or json | No | xml |
Create a Review
| Description | Create an review |
URL | /api/reviews |
| Method | POST |
| Security | Requires User role on the project |
Examples
- Create a review:
- XXX
- XXX
XXX
Parameters
Parameter | Description | Required | Default Value |
|---|---|---|---|
violation_id | Violation on which the review should be created | Yes | None |
status | Initial status (can be 'OPEN' or 'RESOLVED') | Yes | None |
comment | Text of initial comment | Yes | None |
resolution | If status 'RESOLVED', then resolution must be provided (can be 'FIXED' or 'FALSE-POSITIVE') | No | None |
assignee | Login of initial assignee | No | None |
Add a Comment
| Description | Add a comment |
URL | /api/reviews/add_comment |
| Method | PUT |
| Security | Requires User role on the project |
Examples
- Add a comment on review:
- XXX
- XXX
XXX
Parameters
Parameter | Description | Required | Default Value |
|---|---|---|---|
id | Review id | Yes | None |
comment | New comment | Yes | None |
Reassign a Review
| Description | Reassign a review |
URL | /api/reviews/reassign |
| Method | PUT |
| Security | Requires User role on the project |
Examples
- Reassign a review:
- XXX
- XXX
XXX
Parameters
Parameter | Description | Required | Default Value |
|---|---|---|---|
id | Review id | Yes | None |
assignee | Login of new assignee | Yes | None |
Resolve
| Description | Resolve a review |
URL | /api/reviews/resolve |
| Method | PUT |
| Security | Requires User role on the project |
Examples
- Resolve a review:
- XXX
- XXX
XXX
Parameters
Parameter | Description | Required | Default Value |
|---|---|---|---|
id | Review id | Yes | None |
| resolution | Can be 'FIXED' or 'FALSE-POSITIVE' | Yes | None |
comment |
| Yes | None |
Reopen
| Description | Reopen a review |
URL | /api/reviews/reopen |
| Method | PUT |
| Security | Requires User role on the project |
Examples
- Reopen a review:
- XXX
- XXX
XXX
Parameters
Parameter | Description | Required | Default Value |
|---|---|---|---|
id | Review id | Yes | None |
comment |
| Yes | None |

