API V1 to V2 Migration Guide

ProcessUnity GRX is excited to announce that that CyberGRX API V2 is available! This initial release covers the key functionality delivered in API V1 as well as several improvements over the previous version.

With the release of the API V2 we are encouraging customers integrated with API V1 to begin the migration to the new API as soon as possible, in advance of the End of Life (EOL) date August 31, 2024. 

We understand that a migration involves an investment of time and effort on your part and we would like to make the transition as smooth as possible. Please see below for the replacement API V2 for any API V1 endpoints you are currently leveraging.

For more information on API V2 Getting Started, Access & Information, Features & Functionality, check out the API V2 User Guide.

API V1 Endpoint	Replacement API V2 Endpoint(s)
GET /v1/search-third-parties	GET /v2/company/companies
GET /v1/third-parties	GET /v2/portfolio/third-parties
POST /v1/third-parties	POST /v2/portfolio/third-parties
	PUT /v2/portfolio/third-parties/{company_id}
	POST /v2/portfolio/third-parties/{company_id}/requests
GET /v1/third-parties/{third_party_id}	GET /v2/portfolio/third-parties/{company_id}
	GET /v2/portfolio/third-parties/{company_id}/risk-profile - for Inherent and Residual Risk and available assessment dates
DELETE /v1/third-parties/{third_party_id}/tagging	PATCH /v2/portfolio/third-parties/{company_id}
POST /v1/third-parties/{third_party_id}/tagging	PATCH /v2/portfolio/third-parties/{company_id}
PUT /v1/third-parties/{third_party_id}/tagging	PATCH /v2/portfolio/third-parties/{company_id}
PUT /v1/third-parties/{third_party_id}/custom-id	PATCH /v2/portfolio/third-parties/{company_id}
POST /v1/third-parties/{third_party_id}/scoping	PUT /v2/portfolio/third-parties/{company_id}/impact-questionnaire
PUT /v1/third-parties/{third_party_id}/scoping	PUT /v2/portfolio/third-parties/{company_id}/impact-questionnaire
GET /v1/third-parties/{third_party_id}/scores/{report_id}	GET /v2/reporting/frameworks
	GET /v2/portfolio/third-parties/{company_id}/risk-profile
	GET /v2/portfolio/third-parties/{company_id}/risk-navigator/{framework_id}/summary
	GET /v2/portfolio/third-parties/{company_id}/risk-navigator/{framework_id}
GET /v1/third-parties/{third_party_id}/residual-risk/{report_id}	GET /v2/reporting/frameworks
	GET /v2/portfolio/third-parties/{company_id}/risk-profile
	GET /v2/portfolio/third-parties/{company_id}/risk-navigator/{framework_id}/summary
	GET /v2/portfolio/third-parties/{company_id}/risk-navigator/{framework_id}
GET /v1/third-parties/{third_party_id}/report-pdf/{report_id}	POST /v2/reporting/exports
	GET /v2/reporting/exports/{export_id}
	GET /v2/reporting/exports/{export_id}/download