---
title: "Reassess Assessment"
method: POST
path: "/api/assessment/v2/assessments/{id}/reassess"
tags: ["Assessment Actions"]
---

# Reassess Assessment

`POST /api/assessment/v2/assessments/{id}/reassess`

Use this API to launch a reassessment of an existing assessment. The reassessment will use the latest published template version.

> 🗒 Things to Know  
> 
> - Basic assessment details, such as name, organization, deadline, reminder, approver, and respondent, can be copied from the source assessment to the new assessment if the `copyAssessmentMetadata` parameter is set to `true`. Otherwise, `assessmentMetadata` can be passed through the API when the `copyAssessmentMetadata` parameter is set to `false`.
> - The responses, comments, attachments, notes, and linked risks from the original assessment can also be copied to the new assessment using this API.
> - The `archiveSourceAssessment` parameter can be used to indicate whether to archive the source assessment or not.

## Path parameters

- `id` string, uuid, required

## Request body

- PrivacyAutomationAssessmentAutomationReassessAssessmentRequest
  - `assessmentMetadata` PrivacyAutomationAssessmentAutomationAssessmentMetadata
    - `name` string — Name of the assessment
    - `description` string — Description about the assessment
    - `orgGroupId` string, uuid — Organization Group ID to which the assessment belongs to
    - `approvers` PrivacyAutomationAssessmentAutomationAssessmentApproverRequest[]
      - `approverId` string, uuid, required — Unique identifier for the approver
      - `approverName` string — Display name of the approver
      - `comment` string — Optional comment for the approver assignment
      - `workflowStageIds` string[]
    - `respondents` PrivacyAutomationAssessmentAutomationAssessmentRespondentRequest[]
      - `respondentId` string, uuid — Unique identifier for the respondent user
      - `respondentName` string, required — Display name of the respondent
      - `comment` string — Optional comment for the respondent assignment
      - `sectionIds` string[]
      - `isRespondentOfApproverSection` boolean — Flag indicating whether this respondent is assigned to approver sections
    - `respondentCreationType` 'INVITED' | 'PROJECT_RESPONDENT' — Use this field to select if new respondents are created as Invited Users or Project Respondents when calling the Public Reassess API. The 'Allow Creating Project Respondents from Assessment' global setting should be enabled for new users to be set as Project Respondents.
  - `deadline` string, date-time — Deadline (date) to complete the assessment
  - `reminder` integer — Use this field to input the number of days before the deadline to send a automatic notification to the respondent. Deadline must be set for this field to be enabled.Note: Either 'reminder' or 'reminderSchedules' should be provided. If both are present, 'reminder' takes precedence and will be converted to a reminderSchedule for RESPONDENT notification.
  - `Reminder Schedules` PrivacyAutomationAssessmentAutomationReminderScheduleDto[] — list of reminder schedules to trigger the reminder notifications to the configured users e.g respondents or approvers. Note: Either 'reminder' or 'reminderSchedules' should be provided. If both are present, 'reminder' takes precedence and will override this field.
    - `id` string, uuid — Unique identifier for the reminder schedule.
    - `assessmentId` string, uuid — Identifier of the assessment this reminder schedule applies to.
    - `sectionId` string, uuid — Identifier of a specific assessment section this reminder schedule targets (optional).
    - `reminderInterval` integer — Interval in days between consecutive reminders.
    - `reminderReceiverEntityType` 'APPROVER' | 'RESPONDENT' | 'ALL', required — Recipient type who will receive the reminder notifications.
  - `copyAttachments` boolean — This field will copy over the attachments linked to the source assessment.
  - `copyResponses` boolean — This field will copy over the question responses from the source assessment.
  - `copyNotes` boolean — This field will copy over the user notes from the source assessment.
  - `copyComments` boolean — This field will copy over the comments from the source assessment.
  - `linkRisks` boolean — Any risk rules created based on the template risk rules for the original assessment will be linked to the newly created assessment upon submission.
  - `copyAssessmentMetadata` boolean — This field will copy assessment name, description, organisation, approver, respondent details from source assessment to new assessment.
  - `archiveSourceAssessment` boolean — Use this field to provide a "true" or a "false" value to archive the original assessment. When reassessing, setting it to "true" will archive the original assessment and setting it to "false" will not archive the original assessment

## Response `201`

Created

- string, uuid

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Too Many Requests. For more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).
- `500` — Internal Server Error

---

[API](https://skmtc.net/onetrust/apis/platform-access-management.md) · [All operations](https://skmtc.net/onetrust/apis/platform-access-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/onetrust/platform-access-management/revisions/21de3aa0b170/schema)
