--- updatedAt: 2026-05-01T14:34:28.000Z agentTools: projectIndex: https://developer.onetrust.com/onetrust/llms.txt --- # Complete Assessment Use this API to complete review of an assessment using any active result option. This action will move the assessment to the **Completed** stage. > 🗒 Things to Know > > - The assessment must first be submitted for review before using this API. This can be done using the [Submit Assessment API](https://developer.onetrust.com/onetrust/reference/submitassessmentusingpost). > - Only active assessment result options can be used to complete assessments. # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "Privacy Automation - Assessment Automation", "version": "1.0", "contact": { "name": "OneTrust Support", "url": "https://my.onetrust.com/s/contactsupport" }, "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0" }, "description": "The Assessment Automation APIs provide functionality for managing assessment template lifecycle operations, including template export and import for cross-environment migration, retrieving published template metadata with filtering by template type, and template deletion with comprehensive validation checks." }, "servers": [ { "url": "https://{hostname}", "variables": { "hostname": { "default": "hostname", "description": "The OneTrust hostname such as app.onetrust.com, app-eu.onetrust.com, app-de.onetrust.com, app-uk.onetrust.com, app-apac.onetrust.com, trial.onetrust.com, or uat.onetrust.com." } } } ], "tags": [ { "name": "Assessment Actions", "description": "The Assessment Actions APIs are used to perform workflows on assessments, such as launching, approving, or creating tasks.", "externalDocs": { "description": "OpenAPI 3.1.0 - Download Definition", "url": "https://developer.onetrust.com/onetrust/openapi/privacy-automation-assessment-automation.json" }, "x-displayName": "Assessment Actions" } ], "paths": { "/api/assessment/v1/assessments/{assessmentId}/review": { "post": { "operationId": "reviewAssessmentUsingPOST", "summary": "Complete Assessment", "description": "Use this API to complete review of an assessment using any active result option. This action will move the assessment to the **Completed** stage.\n\n> 🗒 Things to Know\n> \n> - The assessment must first be submitted for review before using this API. This can be done using the [Submit Assessment API](https://developer.onetrust.com/onetrust/reference/submitassessmentusingpost).\n> - Only active assessment result options can be used to complete assessments.", "tags": [ "Assessment Actions" ], "x-onetrust": { "spec-label": "https://developer.onetrust.com/onetrust/openapi/privacy-automation-assessment-automation.json" }, "parameters": [ { "name": "assessmentId", "in": "path", "description": "UUID of the assessment to complete", "required": true, "schema": { "type": "string", "format": "uuid" }, "example": "550e8400-e29b-41d4-a716-446655440000" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PrivacyAutomation-AssessmentAutomation_ClosureRequest" } } } }, "responses": { "204": { "description": "No Content" }, "400": { "description": "Bad Request" }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "429": { "description": "Too Many Requests. \nFor more information, see [API Rate Limits](https://developer.onetrust.com/onetrust/reference/rate-limits-overview).", "headers": { "Retry-After": { "schema": { "description": "The number of seconds after which requests will be allowed again.", "format": "int32" } }, "ot-period": { "schema": { "description": "The unit of time for which the rate limit applies", "enum": [ "HOUR", "MINUTE" ] } }, "ot-ratelimit-event-id": { "schema": { "description": "The unique identifier for the rate-limiting event.", "format": "uuid" } }, "ot-request-made": { "schema": { "description": "The number of requests made within the specified period.", "format": "int32" } }, "ot-requests-allowed": { "schema": { "description": "The number of requests allowed within the specified period.", "format": "int32" } } } }, "500": { "description": "Internal Server Error" } }, "security": [ { "PrivacyAutomation-AssessmentAutomation_OAUTH2": [ "ASSESSMENT" ] } ] } } }, "components": { "schemas": { "PrivacyAutomation-AssessmentAutomation_ClosureRequest": { "type": "object", "properties": { "forceOverride": { "description": "Flag to force override any validation errors during closure", "type": "boolean", "example": false, "default": "false" }, "excludeRules": { "description": "Flag to exclude rule execution during closure", "type": "boolean", "example": false, "default": "false" }, "closureComment": { "description": "Comment to include with the assessment closure", "type": "string", "example": "Approved after thorough review. All requirements have been met." }, "resultId": { "description": "Identifier of the result option to apply to the assessment", "type": "string", "format": "uuid", "example": "550e8400-e29b-41d4-a716-446655440000" }, "attestationRequired": { "description": "Flag indicating whether attestation is required for closure", "type": "boolean", "example": false, "default": "false" } } } }, "securitySchemes": { "PrivacyAutomation-AssessmentAutomation_OAUTH2": { "type": "oauth2", "flows": { "clientCredentials": { "tokenUrl": "https://{hostname}/api/access/v1/oauth/token", "scopes": { "ASSESSMENT": "Access to assessment scope for external systems", "ASSESSMENT_READ": "Access to read assessment scope for external systems" } } } } } }, "x-readme": { "explorer-enabled": false, "proxy-enabled": false, "metrics-enabled": false }, "x-onetrust": { "spec-label": "OpenAPI 3.1.0" } } ``` # Sibling pages * [Launch Assessment](https://developer.onetrust.com/onetrust/reference/createassessmentusingpost.md) * [Launch Assessments in Bulk](https://developer.onetrust.com/onetrust/reference/createbulkassessmentusingpost.md) * [Launch Assessment](https://developer.onetrust.com/onetrust/reference/createassessmentusingpost_1.md) * [Reassign Assessment](https://developer.onetrust.com/onetrust/reference/reassignassessmentusingput.md) * [Create Assessment Task](https://developer.onetrust.com/onetrust/reference/createtaskusingpost.md) * [Reassess Assessment](https://developer.onetrust.com/onetrust/reference/reassessassessmentusingpost.md) * [Reopen Assessment](https://developer.onetrust.com/onetrust/reference/reopenassessmentusingpost.md) * [Send Back Assessment](https://developer.onetrust.com/onetrust/reference/sendbackassessmenttoinprogressusingpost.md) * [Approve Assessment](https://developer.onetrust.com/onetrust/reference/approveassessmentusingpost.md) * [Submit Responses](https://developer.onetrust.com/onetrust/reference/submitresponsesusingpost.md) * [Create Assessment Risk](https://developer.onetrust.com/onetrust/reference/createassessmentriskusingpost.md) * [Submit Assessment](https://developer.onetrust.com/onetrust/reference/submitassessmentusingpost.md)