API versions
From P4 Code Review 2022.1, we added a new set of v11 APIs to P4 Code Review that replace the v10 APIs. The v11 APIs refine and extend the v10 APIs, and further standardize the endpoint and response pattern.
The v9 and v10 APIs will continue to be available for some time to come, but their functionality will be duplicated and expanded in the v11 APIs over the next few releases. v11 does not currently provide a full set of features, so it is recommended that you use v9 for now if the features that you need are not present in v11.
- From P4 Code Review 2022.2, P4 Code Review no longer supports APIs older than v9. P4 Code Review will continue to support the v9 APIs and you can continue to use them if you prefer.
- Any improvements made in the migration to v11 will not be backported to v9 or v10.
- New API endpoints will be created as v11 and will not be backported to v9 or v10.
Current API versions
| API version | P4 Code Review Release | Date | Description |
|---|---|---|---|
|
v11 |
2022.1 |
March 2022 |
Extended the v10 APIs and further standardized the endpoint and response pattern for the new rich User Interface. |
|
v10 |
2019.3 |
October 2019 |
Include support for integration with CI tools. |
|
v9 |
2018.1 |
April 2018 |
Include support for append and replace changelist to a review, 2 Factor Authentication and mark a comment as read. |
Unsupported API versions
From P4 Code Review 2022.2, P4 Code Review no longer supports APIs older than v9.
| API version | P4 Code Review Release | Date | Description |
|---|---|---|---|
|
v8 |
2017.4 |
December 2017 |
Include support for default reviewers on a project or project branch. |
|
v7 |
2017.3 |
October 2017 |
Include support for groups as participants of a review and groups as moderators of a project branch. |
|
v6 |
2017.1 |
May 2017 |
Include support for activity dashboard, archiving of inactive reviews, cleaning completed reviews and for voting reviews up and down. |
|
v5 |
2016.3 |
December 2016 |
Include support for limiting comments to a specific review version. |
|
v4 |
2016.2 |
October 2016 |
Include support for private projects, as well as file-level and line-level inline comments. |
|
v3 |
2016.1 SP1 |
September 2016 |
Include new endpoint for comments. |
|
v2 |
2016.1 |
May 2016 |
Include new endpoints for projects, groups, etc. |
|
v1.2 |
2015.3 |
October 2015 |
Add author filter to the list reviews endpoint. |
|
v1.1 |
2014.4 |
January 2015 |
Addition of required reviewers, and |
|
v1 |
2014.3 |
July 2014 |
Initial release. |
Get P4 Code Review version information
The version endpoint lets you see the currently-installed P4 Code Review version, the year of release, and the included API versions.
GET /api/version
Get P4 Code Review version and API versions:
https://myswarm.url/api/version
Example response:
{"apiVersions":[1,1.1,1.2,2,3,4,5,6,7,8,9,10,11],"version":"SWARM\/2022.1\/2139325(2022\/01\/28)","year":"2022"}
year refers to the year of the P4 Code Review release, not necessarily the current year.