Reassign Assessment

Use this API to reassign the organization, approvers, and/or respondents of an assessment. The assessment will be updated with the new organization, approvers, and/or respondents provided in the request body.

🗒

Things to Know

  • If the assessment is in Completed stage, reassignments made using this API will be ignored.

  • The reassigned respondents and/or approvers should exist in the orgGroupId provided in the request.

  • New respondents that do not already exist in the application will be created as Invited Users unless PROJECT_RESPONDENT is specified in the respondentCreationType parameter.

  • If an update is made using this API, an event will be shown in the Assessment Activity.

  • This API can update assessments of the following types: PIA, Vendor, ITRM, Control, Exchange, and Incident.

  • The stageId parameter values returned in the Get Assessment Workflow Stages API response can be used to reassign approvers to different stages of an assessment.

Path Params
uuid
required

UUID of the assessment to reassign

Body Params
uuid

The ID of the organization that the assessment should be reassigned to

approvers
array of objects
length ≥ 0

The user(s) that will override the current approvers if any are added

approvers
respondents
array of objects
length ≥ 0

The user(s) that will override the current respondents if any are added

respondents
string
enum
Defaults to INVITED

If adding new users that don't already exist, this is the type of user they will be created as

Allowed:
Responses
204

No Content

400

Bad Request

401

Unauthorized

403

Forbidden

500

Internal Server Error

Language
Credentials
OAuth2
Missing 2 required scopes
URL
Response
Click Try It! to start a request and see the response here! Or choose an example:
*/*