Vendor Security Reviews track the status of security reviews for Vendors. You can create a security review, upload questionnaires, and track the progress of the review. Each review produces Assessments, the per-criterion findings that carry an analysis summary, status, and severity. The help docs have more information.
Get a paginated list of Assessments for a given Vendor Security Review.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: List Assessments permission.
๐ Requires your account have the TPRM Agentic Assessment, AI Data Share feature. Contact your Account Manager for help upgrading.
๐ Requires the company's AI features setting turned on. Otherwise it returns 403 AI_FORBIDDEN.
Successful
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action AI features are not enabled for this account.
The Vendor has no Vendor Security Review with the given securityReviewId
You must accept the Drata terms and conditions to use the API
Internal server error
{- "data": [
- {
- "id": 1,
- "vendorSecurityReviewId": 5,
- "vendorAssessmentCriteriaId": 123,
- "criteriaName": "My Criteria",
- "analysisSummary": "Analysis summary content",
- "originalAgentStatus": "MET",
- "currentStatus": "MET",
- "severity": "HIGH",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "pagination": {
- "cursor": "string",
- "totalCount": 0
}
}Get one Assessment of a Vendor Security Review, including the Vendor Document excerpts the agent cited and the criterion requirements it tested.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Get Assessment permission.
๐ Requires your account have the TPRM Agentic Assessment, AI Data Share feature. Contact your Account Manager for help upgrading.
๐ Requires the company's AI features setting turned on. Otherwise it returns 403 AI_FORBIDDEN.
Successful
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action AI features are not enabled for this account.
The Vendor has no Vendor Security Review with the given securityReviewId, or the review has no Assessment with the given assessmentId
You must accept the Drata terms and conditions to use the API
Internal server error
{- "id": 1,
- "vendorSecurityReviewId": 5,
- "vendorAssessmentCriteriaId": 123,
- "criteriaName": "My Criteria",
- "analysisSummary": "Analysis summary content",
- "originalAgentStatus": "MET",
- "currentStatus": "MET",
- "severity": "HIGH",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "sources": [
- {
- "documentId": 42,
- "documentName": "SOC 2 Type II Report.pdf",
- "documentExcerpt": "All customer data is encrypted at rest using AES-256.",
- "pageNumber": 12,
- "referencedOn": "2025-07-01T16:45:55.246Z"
}
], - "requirements": [
- {
- "question": "Is customer data encrypted at rest?",
- "explanation": "The SOC 2 report states that customer data is encrypted at rest with AES-256.",
- "status": "MET",
- "sources": [
- {
- "documentId": 42,
- "documentName": "SOC 2 Type II Report.pdf",
- "documentExcerpt": "All customer data is encrypted at rest using AES-256.",
- "pageNumber": 12,
- "referencedOn": "2025-07-01T16:45:55.246Z"
}
]
}
]
}Count the Assessments of a Vendor Security Review by current status: met, not met, partially met, inconclusive and not applicable.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Get Assessments Statistics permission.
๐ Requires your account have the TPRM Agentic Assessment, AI Data Share feature. Contact your Account Manager for help upgrading.
๐ Requires the company's AI features setting turned on. Otherwise it returns 403 AI_FORBIDDEN.
Successful
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action AI features are not enabled for this account.
The Vendor has no Vendor Security Review with the given securityReviewId
You must accept the Drata terms and conditions to use the API
Internal server error
{- "met": 30,
- "notMet": 5,
- "partiallyMet": 4,
- "inconclusive": 3,
- "notApplicable": 1,
- "total": 44
}Get a paginated list of Observations for a given Vendor Security Review.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Get Security Review Observations permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Successful
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
The Vendor has no Vendor Security Review with the given securityReviewId
You must accept the Drata terms and conditions to use the API
Internal server error
{- "data": [
- {
- "id": 1,
- "securityReviewId": 1,
- "observation": "Vendor provided a SOC 2 Type II report covering all five trust service criteria.",
- "source": "SOC 2 Type II report",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "userId": 1,
- "vendorAssessmentId": 1,
- "user": {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
}
], - "pagination": {
- "cursor": "string",
- "totalCount": 0
}
}Record an Observation against a given Vendor Security Review, optionally related to the assessment of one of its criteria through vendorAssessmentId. A Vendor Security Review holds at most 250 Observations and Notes together; past it the request fails with 400.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Create Security Review Observation permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Created
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
The Vendor has no Vendor Security Review with the given securityReviewId
You must accept the Drata terms and conditions to use the API
The vendorAssessmentId is not an assessment of this Vendor Security Review.
Internal server error
{- "observation": "No evidence of annual penetration testing.",
- "source": "SOC 2 Type II report, section 4",
- "vendorAssessmentId": 345
}{- "id": 1,
- "securityReviewId": 1,
- "observation": "Vendor provided a SOC 2 Type II report covering all five trust service criteria.",
- "source": "SOC 2 Type II report",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "userId": 1,
- "vendorAssessmentId": 1,
- "user": {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
}Get an Observation of a given Vendor Security Review.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Get Security Review Observations permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Successful
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
The Vendor has no Vendor Security Review with the given securityReviewId, or the Vendor Security Review has no Observation with the given observationId
You must accept the Drata terms and conditions to use the API
Internal server error
{- "id": 1,
- "securityReviewId": 1,
- "observation": "Vendor provided a SOC 2 Type II report covering all five trust service criteria.",
- "source": "SOC 2 Type II report",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "userId": 1,
- "vendorAssessmentId": 1,
- "user": {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
}Update the text or source of an Observation of a given Vendor Security Review. Omitted fields keep their value; a body with no field returns 204 and changes nothing.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Update Security Review Observation permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Successful
No Content
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
The API key or OAuth token lacks the permission or scope, the user cannot access this Vendor, or the user is not the author of the Observation: only its author can update it.
The Vendor has no Vendor Security Review with the given securityReviewId, or the Vendor Security Review has no Observation with the given observationId
You must accept the Drata terms and conditions to use the API
Internal server error
{- "observation": "No evidence of annual penetration testing in the last 24 months.",
- "source": "SOC 2 Type II report, section 4"
}{- "id": 1,
- "securityReviewId": 1,
- "observation": "Vendor provided a SOC 2 Type II report covering all five trust service criteria.",
- "source": "SOC 2 Type II report",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "userId": 1,
- "vendorAssessmentId": 1,
- "user": {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
}Delete an Observation of a given Vendor Security Review.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Delete Security Review Observation permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
No Content
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
The API key or OAuth token lacks the permission or scope, the user cannot access this Vendor, or the user is not the author of the Observation: only its author can delete it.
The Vendor has no Vendor Security Review with the given securityReviewId, or the Vendor Security Review has no Observation with the given observationId
You must accept the Drata terms and conditions to use the API
Internal server error
{- "name": "string",
- "statusCode": 0,
- "message": "string",
- "code": 0
}Return the Recommended Residual Risk evaluation for a Vendor Security Review: the deterministic score and Risk level, the confidence flag, and the supporting breakdown and persisted reasoning.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Get Security Review Residual Risk permission.
๐ Requires your account have the TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Successful
Malformed data and/or validation errors
Invalid Authorization
The account is not on the TPRM Pro Max plan.
The caller lacks the required permission or OAuth scope, has restricted vendor access that excludes this Vendor, or the feature is not enabled for the account.
The Vendor has no Security Review with the given securityReviewId.
You must accept the Drata terms and conditions to use the API
Unprocessable Entity
Internal server error
{- "score": 0.67,
- "recommendedRiskLevel": {
- "id": 3,
- "name": "Major",
- "position": 3
}, - "confidence": "HIGH",
- "exceedsInherentRisk": false,
- "breakdown": {
- "conclusiveCount": 8,
- "inconclusiveCount": 2,
- "notApplicableCount": 1,
- "scoredCount": 8,
- "totalApplicableCount": 10,
- "inconclusiveShare": 0.2,
- "thresholds": [
- 0.25,
- 0.5,
- 0.75,
- 1
], - "weightedGapTotal": 8,
- "totalPossiblePoints": 12
}, - "reason": "AWS is a Tier 1 vendor, so inherent risk is High. Of 10 applicable criteria, 8 are conclusive (5 met, 3 with gaps) and 2 are inconclusive and excluded. Strong, independently attested MFA and encryption controls support a recommended residual of Major.",
- "confidenceCaveat": false,
- "reasonGeneratedAt": "2025-07-01T16:45:55.246Z",
- "stale": false
}Set the Residual Risk of the Vendor to the given Risk level as the outcome of a Vendor Security Review, and return the refreshed Recommended Residual Risk evaluation.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Update Security Review Residual Risk permission.
๐ Requires your account have the TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Successful
Malformed data and/or validation errors
Invalid Authorization
The account is not on the TPRM Pro Max plan.
The caller lacks the required permission or OAuth scope, has restricted vendor access that excludes this Vendor, or the feature is not enabled for the account.
The Vendor has no Security Review with the given securityReviewId.
You must accept the Drata terms and conditions to use the API
The residualRiskLevelId is not an active, non-system Risk level of the account.
Internal server error
{- "residualRiskLevelId": 3
}{- "score": 0.67,
- "recommendedRiskLevel": {
- "id": 3,
- "name": "Major",
- "position": 3
}, - "confidence": "HIGH",
- "exceedsInherentRisk": false,
- "breakdown": {
- "conclusiveCount": 8,
- "inconclusiveCount": 2,
- "notApplicableCount": 1,
- "scoredCount": 8,
- "totalApplicableCount": 10,
- "inconclusiveShare": 0.2,
- "thresholds": [
- 0.25,
- 0.5,
- 0.75,
- 1
], - "weightedGapTotal": 8,
- "totalPossiblePoints": 12
}, - "reason": "AWS is a Tier 1 vendor, so inherent risk is High. Of 10 applicable criteria, 8 are conclusive (5 met, 3 with gaps) and 2 are inconclusive and excluded. Strong, independently attested MFA and encryption controls support a recommended residual of Major.",
- "confidenceCaveat": false,
- "reasonGeneratedAt": "2025-07-01T16:45:55.246Z",
- "stale": false
}Get a paginated list of Internal Notes for a given Vendor Security Review.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Get Security Review Notes permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Successful
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
The Vendor has no Vendor Security Review with the given securityReviewId
You must accept the Drata terms and conditions to use the API
Internal server error
{- "data": [
- {
- "id": 1,
- "securityReviewId": 1,
- "note": "Procurement approved the exception until the next renewal.",
- "source": "Procurement ticket PROC-1234",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "userId": 1,
- "vendorAssessmentId": 345,
- "user": {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
}
], - "pagination": {
- "cursor": "string",
- "totalCount": 0
}
}Record an Internal Note against a given Vendor Security Review, optionally related to the assessment of one of its criteria through vendorAssessmentId. A Vendor Security Review holds at most 250 Observations and Notes together; past it the request fails with 400.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Create Security Review Note permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Created
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
The Vendor has no Vendor Security Review with the given securityReviewId
You must accept the Drata terms and conditions to use the API
The vendorAssessmentId is not an assessment of this Vendor Security Review.
Internal server error
{- "note": "Procurement approved the exception until the next renewal.",
- "source": "Procurement ticket PROC-1234",
- "vendorAssessmentId": 345
}{- "id": 1,
- "securityReviewId": 1,
- "note": "Procurement approved the exception until the next renewal.",
- "source": "Procurement ticket PROC-1234",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "userId": 1,
- "vendorAssessmentId": 345,
- "user": {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
}Get an Internal Note of a given Vendor Security Review.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Get Security Review Notes permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Successful
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
The Vendor has no Vendor Security Review with the given securityReviewId, or the Vendor Security Review has no Note with the given securityReviewNoteId
You must accept the Drata terms and conditions to use the API
Internal server error
{- "id": 1,
- "securityReviewId": 1,
- "note": "Procurement approved the exception until the next renewal.",
- "source": "Procurement ticket PROC-1234",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "userId": 1,
- "vendorAssessmentId": 345,
- "user": {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
}Update the text or source of an Internal Note of a given Vendor Security Review. Omitted fields keep their value; a body with no field returns 204 and changes nothing.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Update Security Review Note permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Successful
No Content
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
The API key or OAuth token lacks the permission or scope, the user cannot access this Vendor, or the user is not the author of the Note: only its author can update it.
The Vendor has no Vendor Security Review with the given securityReviewId, or the Vendor Security Review has no Note with the given securityReviewNoteId
You must accept the Drata terms and conditions to use the API
Internal server error
{- "note": "Procurement extended the exception for one more quarter.",
- "source": "Procurement ticket PROC-1234"
}{- "id": 1,
- "securityReviewId": 1,
- "note": "Procurement approved the exception until the next renewal.",
- "source": "Procurement ticket PROC-1234",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "userId": 1,
- "vendorAssessmentId": 345,
- "user": {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
}Delete an Internal Note of a given Vendor Security Review.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Delete Security Review Note permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
No Content
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
The API key or OAuth token lacks the permission or scope, the user cannot access this Vendor, or the user is not the author of the Note: only its author can delete it.
The Vendor has no Vendor Security Review with the given securityReviewId, or the Vendor Security Review has no Note with the given securityReviewNoteId
You must accept the Drata terms and conditions to use the API
Internal server error
{- "name": "string",
- "statusCode": 0,
- "message": "string",
- "code": 0
}Get the vendor assessment agent workflow for a Security Review. Returns a null workflow when no assessment workflow exists for the review.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Get Security Review Workflow permission.
๐ Requires your account have the TPRM Agentic Assessment, AI Data Share feature. Contact your Account Manager for help upgrading.
๐ Requires the company's AI features setting turned on. Otherwise it returns 403 AI_FORBIDDEN.
Successful
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action AI features are not enabled for this account.
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "workflow": {
- "id": 1,
- "workspaceId": 1,
- "vendorSecurityReviewId": 456,
- "status": "NOT_STARTED",
- "progress": 50,
- "auditTrail": [
- {
- "key": "PROCESS_DOCUMENTS",
- "name": "Security review started",
- "status": "COMPLETED",
- "date": "2025-07-01T16:45:55.246Z"
}
], - "documents": {
- "data": [
- {
- "id": 123,
- "name": "SOC 2 Type II Report.pdf",
- "type": "DOCUMENT",
- "status": "PROCESSED"
}
], - "totalCount": 3
}, - "runs": {
- "data": [
- {
- "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
- "status": "COMPLETED",
- "stats": {
- "met": 15,
- "notMet": 3,
- "inconclusive": 2,
- "partiallyMet": 1,
- "overallSecurityPosture": "Met"
}, - "startedAt": "2025-07-01T16:45:55.246Z",
- "completedAt": "2025-07-01T16:45:55.246Z",
- "isPublicDocsOnly": true
}
], - "totalCount": 2
}
}
}Get a paginated list of all Security Reviews for a given Vendor.
๐ Requires Vendors: List Vendors permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Successful
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "data": [
- {
- "id": 1,
- "requestedAt": "2025-07-01T16:45:55.246Z",
- "reviewDeadlineAt": "2025-07-01T16:45:55.246Z",
- "decision": "APPROVED",
- "title": "string",
- "note": "string",
- "status": "NOT_YET_STARTED",
- "type": "SECURITY",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "vendorId": 1,
- "vendor": {
- "id": 1,
- "name": "Acme"
}, - "userId": 0,
- "requesterUserId": 0,
- "user": {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}, - "requesterUser": {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}, - "socReviewForm": {
- "readyToFinalize": false,
- "reviewerInformation": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "reviewer": "Jane Doe",
- "reportIssueDate": "2020-07-06"
}, - "complianceScope": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "certification": "SOC_2",
- "scopeType": "TYPE_2",
- "auditPeriod": "2020-07-06",
- "auditPeriodRange": {
- "start": "2020-07-06",
- "end": "2020-07-06"
}, - "trustServiceCriteria": [
- "AVAILABILITY"
]
}, - "reportOpinion": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "reportOpinion": "UNQUALIFIED",
- "encompassBusinessNeeds": true,
- "followUpActivity": "Schedule a follow-up review in 90 days."
}, - "findings": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "findings": [
- {
- "description": "Control objective was not met during the audit period."
}
], - "hasMaterialImpact": false
}, - "endUserControls": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "userControls": [
- {
- "description": "Users must enforce strong password policies.",
- "inPlace": true
}
]
}, - "servicesAndLocations": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "services": [
- {
- "name": "Cloud Hosting"
}
], - "locations": [
- {
- "city": "Austin",
- "stateOrCountry": "TX"
}
]
}, - "cpaFirm": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "cpaFirm": "Deloitte",
- "cpaProcedurePerformed": "Assessed reputation via public records."
}, - "subserviceOrganizations": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "subserviceOrganization": "SubCo Inc.",
- "subserviceOrganizationUsingInclusiveMethod": true,
- "subserviceOrganizationProcedurePerformed": "Reviewed available SOC reports."
}
}
}
], - "pagination": {
- "cursor": "string",
- "totalCount": 0
}
}Create a new Security Review for a given Vendor.
๐ Requires Vendors: Create Security Review permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Created
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "reviewDeadlineAt": "2025-07-01T16:45:55.246Z",
- "securityReviewStatus": "NOT_YET_STARTED",
- "securityReviewType": "SECURITY",
- "requestedAt": "2025-07-01T16:45:55.246Z",
- "note": "Security Review note",
- "requesterUserId": 1,
- "title": "Security Review title"
}{- "id": 1,
- "requestedAt": "2025-07-01T16:45:55.246Z",
- "reviewDeadlineAt": "2025-07-01T16:45:55.246Z",
- "decision": "APPROVED",
- "title": "string",
- "note": "string",
- "status": "NOT_YET_STARTED",
- "type": "SECURITY",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "vendorId": 1,
- "vendor": {
- "id": 1,
- "name": "Acme"
}, - "userId": 0,
- "requesterUserId": 0,
- "user": {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}, - "requesterUser": {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}, - "socReviewForm": {
- "readyToFinalize": false,
- "reviewerInformation": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "reviewer": "Jane Doe",
- "reportIssueDate": "2020-07-06"
}, - "complianceScope": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "certification": "SOC_2",
- "scopeType": "TYPE_2",
- "auditPeriod": "2020-07-06",
- "auditPeriodRange": {
- "start": "2020-07-06",
- "end": "2020-07-06"
}, - "trustServiceCriteria": [
- "AVAILABILITY"
]
}, - "reportOpinion": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "reportOpinion": "UNQUALIFIED",
- "encompassBusinessNeeds": true,
- "followUpActivity": "Schedule a follow-up review in 90 days."
}, - "findings": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "findings": [
- {
- "description": "Control objective was not met during the audit period."
}
], - "hasMaterialImpact": false
}, - "endUserControls": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "userControls": [
- {
- "description": "Users must enforce strong password policies.",
- "inPlace": true
}
]
}, - "servicesAndLocations": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "services": [
- {
- "name": "Cloud Hosting"
}
], - "locations": [
- {
- "city": "Austin",
- "stateOrCountry": "TX"
}
]
}, - "cpaFirm": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "cpaFirm": "Deloitte",
- "cpaProcedurePerformed": "Assessed reputation via public records."
}, - "subserviceOrganizations": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "subserviceOrganization": "SubCo Inc.",
- "subserviceOrganizationUsingInclusiveMethod": true,
- "subserviceOrganizationProcedurePerformed": "Reviewed available SOC reports."
}
}
}Create a new Security Review for a given Vendor with file upload in a single atomic operation.
๐ Requires Vendors: Create Security Review permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Created
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "title": "Q4 2024 Security Review",
- "reviewDeadlineAt": "2025-07-01T16:45:55.246Z",
- "requestedAt": "2024-01-01T00:00:00.000Z",
- "securityReviewStatus": 3,
- "securityReviewType": 1,
- "requesterUserId": 123,
- "note": "Additional notes about the security review",
- "documentType": 1,
- "file": "string"
}{- "id": 1,
- "requestedAt": "2025-07-01T16:45:55.246Z",
- "reviewDeadlineAt": "2025-07-01T16:45:55.246Z",
- "decision": "APPROVED",
- "title": "string",
- "note": "string",
- "status": "NOT_YET_STARTED",
- "type": "SECURITY",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "vendorId": 1,
- "vendor": {
- "id": 1,
- "name": "Acme"
}, - "userId": 0,
- "requesterUserId": 0,
- "user": {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}, - "requesterUser": {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}, - "socReviewForm": {
- "readyToFinalize": false,
- "reviewerInformation": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "reviewer": "Jane Doe",
- "reportIssueDate": "2020-07-06"
}, - "complianceScope": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "certification": "SOC_2",
- "scopeType": "TYPE_2",
- "auditPeriod": "2020-07-06",
- "auditPeriodRange": {
- "start": "2020-07-06",
- "end": "2020-07-06"
}, - "trustServiceCriteria": [
- "AVAILABILITY"
]
}, - "reportOpinion": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "reportOpinion": "UNQUALIFIED",
- "encompassBusinessNeeds": true,
- "followUpActivity": "Schedule a follow-up review in 90 days."
}, - "findings": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "findings": [
- {
- "description": "Control objective was not met during the audit period."
}
], - "hasMaterialImpact": false
}, - "endUserControls": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "userControls": [
- {
- "description": "Users must enforce strong password policies.",
- "inPlace": true
}
]
}, - "servicesAndLocations": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "services": [
- {
- "name": "Cloud Hosting"
}
], - "locations": [
- {
- "city": "Austin",
- "stateOrCountry": "TX"
}
]
}, - "cpaFirm": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "cpaFirm": "Deloitte",
- "cpaProcedurePerformed": "Assessed reputation via public records."
}, - "subserviceOrganizations": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "subserviceOrganization": "SubCo Inc.",
- "subserviceOrganizationUsingInclusiveMethod": true,
- "subserviceOrganizationProcedurePerformed": "Reviewed available SOC reports."
}
}
}Get a paginated list of Security Reviews across all Vendors in the account, subject to the caller's vendor access. Supports the same filters as the per-vendor list plus optional vendorIds[] narrowing. When the caller has restricted vendor access, results are limited to the intersection of the vendors they are permitted to see and the (optional) vendorIds[] filter.
๐ Requires Vendors: List Vendors permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Successful
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
You must accept the Drata terms and conditions to use the API
Internal server error
{- "data": [
- {
- "id": 1,
- "requestedAt": "2025-07-01T16:45:55.246Z",
- "reviewDeadlineAt": "2025-07-01T16:45:55.246Z",
- "decision": "APPROVED",
- "title": "string",
- "note": "string",
- "status": "NOT_YET_STARTED",
- "type": "SECURITY",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "vendorId": 1,
- "vendor": {
- "id": 1,
- "name": "Acme"
}, - "userId": 0,
- "requesterUserId": 0,
- "user": {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}, - "requesterUser": {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}, - "socReviewForm": {
- "readyToFinalize": false,
- "reviewerInformation": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "reviewer": "Jane Doe",
- "reportIssueDate": "2020-07-06"
}, - "complianceScope": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "certification": "SOC_2",
- "scopeType": "TYPE_2",
- "auditPeriod": "2020-07-06",
- "auditPeriodRange": {
- "start": "2020-07-06",
- "end": "2020-07-06"
}, - "trustServiceCriteria": [
- "AVAILABILITY"
]
}, - "reportOpinion": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "reportOpinion": "UNQUALIFIED",
- "encompassBusinessNeeds": true,
- "followUpActivity": "Schedule a follow-up review in 90 days."
}, - "findings": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "findings": [
- {
- "description": "Control objective was not met during the audit period."
}
], - "hasMaterialImpact": false
}, - "endUserControls": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "userControls": [
- {
- "description": "Users must enforce strong password policies.",
- "inPlace": true
}
]
}, - "servicesAndLocations": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "services": [
- {
- "name": "Cloud Hosting"
}
], - "locations": [
- {
- "city": "Austin",
- "stateOrCountry": "TX"
}
]
}, - "cpaFirm": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "cpaFirm": "Deloitte",
- "cpaProcedurePerformed": "Assessed reputation via public records."
}, - "subserviceOrganizations": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "subserviceOrganization": "SubCo Inc.",
- "subserviceOrganizationUsingInclusiveMethod": true,
- "subserviceOrganizationProcedurePerformed": "Reviewed available SOC reports."
}
}
}
], - "pagination": {
- "cursor": "string",
- "totalCount": 0
}
}Get a specific Security Review for a given Vendor. For SOC_REPORT reviews the response includes a socReview field with the SOC form data.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: List Vendors permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Successful
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "id": 1,
- "requestedAt": "2025-07-01T16:45:55.246Z",
- "reviewDeadlineAt": "2025-07-01T16:45:55.246Z",
- "decision": "APPROVED",
- "title": "string",
- "note": "string",
- "status": "NOT_YET_STARTED",
- "type": "SECURITY",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "vendorId": 1,
- "vendor": {
- "id": 1,
- "name": "Acme"
}, - "userId": 0,
- "requesterUserId": 0,
- "user": {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}, - "requesterUser": {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}, - "socReviewForm": {
- "readyToFinalize": false,
- "reviewerInformation": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "reviewer": "Jane Doe",
- "reportIssueDate": "2020-07-06"
}, - "complianceScope": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "certification": "SOC_2",
- "scopeType": "TYPE_2",
- "auditPeriod": "2020-07-06",
- "auditPeriodRange": {
- "start": "2020-07-06",
- "end": "2020-07-06"
}, - "trustServiceCriteria": [
- "AVAILABILITY"
]
}, - "reportOpinion": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "reportOpinion": "UNQUALIFIED",
- "encompassBusinessNeeds": true,
- "followUpActivity": "Schedule a follow-up review in 90 days."
}, - "findings": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "findings": [
- {
- "description": "Control objective was not met during the audit period."
}
], - "hasMaterialImpact": false
}, - "endUserControls": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "userControls": [
- {
- "description": "Users must enforce strong password policies.",
- "inPlace": true
}
]
}, - "servicesAndLocations": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "services": [
- {
- "name": "Cloud Hosting"
}
], - "locations": [
- {
- "city": "Austin",
- "stateOrCountry": "TX"
}
]
}, - "cpaFirm": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "cpaFirm": "Deloitte",
- "cpaProcedurePerformed": "Assessed reputation via public records."
}, - "subserviceOrganizations": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "subserviceOrganization": "SubCo Inc.",
- "subserviceOrganizationUsingInclusiveMethod": true,
- "subserviceOrganizationProcedurePerformed": "Reviewed available SOC reports."
}
}
}Update a Vendor Security Review. The title field applies to all security review types. The socForm field is only processed when securityReviewType is SOC_REPORT. The updatedAt field overrides the review's last-updated timestamp (surfaced as the vendor's last review date) and is the only field that may be set on a completed review.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Update Security Review permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Successful
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "title": "string",
- "socForm": {
- "reviewerInformation": {
- "reviewerUserId": 42,
- "reportIssueDate": "2020-07-06"
}, - "complianceScope": {
- "certification": "SOC_2",
- "scopeType": "TYPE_2",
- "auditPeriod": "2020-07-06",
- "auditPeriodRange": {
- "start": "2020-07-06",
- "end": "2020-07-06"
}, - "trustServiceCriteria": [
- "AVAILABILITY"
]
}, - "reportOpinion": {
- "reportOpinion": "UNQUALIFIED",
- "encompassBusinessNeeds": true,
- "followUpActivity": "string"
}, - "findings": {
- "findings": [
- {
- "description": "string"
}
], - "hasMaterialImpact": false
}, - "endUserControls": {
- "userControls": [
- {
- "description": "string",
- "inPlace": true
}
]
}, - "servicesAndLocations": {
- "services": [
- {
- "name": "string"
}
], - "locations": [
- {
- "city": "Austin",
- "stateOrCountry": "TX"
}
]
}, - "cpaFirm": {
- "cpaFirm": "Deloitte",
- "cpaProcedurePerformed": "string"
}, - "subserviceOrganizations": {
- "subserviceOrganization": "string",
- "subserviceOrganizationUsingInclusiveMethod": true,
- "subserviceOrganizationProcedurePerformed": "string"
}
}, - "updatedAt": "2025-07-01T16:45:55.246Z"
}{- "id": 1,
- "requestedAt": "2025-07-01T16:45:55.246Z",
- "reviewDeadlineAt": "2025-07-01T16:45:55.246Z",
- "decision": "APPROVED",
- "title": "string",
- "note": "string",
- "status": "NOT_YET_STARTED",
- "type": "SECURITY",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "vendorId": 1,
- "vendor": {
- "id": 1,
- "name": "Acme"
}, - "userId": 0,
- "requesterUserId": 0,
- "user": {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}, - "requesterUser": {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}, - "socReviewForm": {
- "readyToFinalize": false,
- "reviewerInformation": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "reviewer": "Jane Doe",
- "reportIssueDate": "2020-07-06"
}, - "complianceScope": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "certification": "SOC_2",
- "scopeType": "TYPE_2",
- "auditPeriod": "2020-07-06",
- "auditPeriodRange": {
- "start": "2020-07-06",
- "end": "2020-07-06"
}, - "trustServiceCriteria": [
- "AVAILABILITY"
]
}, - "reportOpinion": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "reportOpinion": "UNQUALIFIED",
- "encompassBusinessNeeds": true,
- "followUpActivity": "Schedule a follow-up review in 90 days."
}, - "findings": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "findings": [
- {
- "description": "Control objective was not met during the audit period."
}
], - "hasMaterialImpact": false
}, - "endUserControls": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "userControls": [
- {
- "description": "Users must enforce strong password policies.",
- "inPlace": true
}
]
}, - "servicesAndLocations": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "services": [
- {
- "name": "Cloud Hosting"
}
], - "locations": [
- {
- "city": "Austin",
- "stateOrCountry": "TX"
}
]
}, - "cpaFirm": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "cpaFirm": "Deloitte",
- "cpaProcedurePerformed": "Assessed reputation via public records."
}, - "subserviceOrganizations": {
- "isComplete": false,
- "missingRequiredFields": [
- "reviewerInformation.reviewer"
], - "subserviceOrganization": "SubCo Inc.",
- "subserviceOrganizationUsingInclusiveMethod": true,
- "subserviceOrganizationProcedurePerformed": "Reviewed available SOC reports."
}
}
}Get the status of a Vendor Security Review summary PDF. When status is READY the response includes document, a time-limited signed downloadUrl for the most recently generated summary PDF. Use the document createdAt to judge freshness: a reopened review that has not regenerated its summary may still surface the prior finalization PDF. GENERATING means the summary is still being produced; NOT_GENERATING means none is available (never requested, not eligible, or the last generation failed โ these are not distinguished). Access requires the vendor read scope (read:vendor-security-review). This endpoint is a read-only status check; it does not itself generate or deliver the summary.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: List Vendors permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Successful
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "status": "READY",
- "document": {
- "id": 1,
- "name": "AWS SOC 2 2025",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "type": "COMPLIANCE_REPORT",
- "downloadUrl": {
- "fileBuffer": {
- "buffer": "RXhhbXBsZSB0ZXh0IGNvbnRlbnQ="
}, - "fileName": "Artifact 3.png"
}
}
}๐ Requires Vendors: Upload Security Questionnaire permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Created
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "id": 1,
- "completedBy": "Acme",
- "isCompleted": "true",
- "dateSent": "2025-07-01T16:45:55.246Z",
- "isManualUpload": "true",
- "responseId": 1,
- "title": "Vendor Security Questionnaire",
- "status": "SENT",
- "completedAt": "2025-07-01T16:45:55.246Z",
- "totalQuestions": 10,
- "totalQuestionsAnswered": 10,
- "reminderDate": "2025-07-01T16:45:55.246Z"
}List the questionnaires that belong to a Vendor Security Review. Cursor-paginated. Archived or soft-deleted questionnaires are excluded from the response.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: List Vendor Questionnaire permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Successful
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "data": [
- {
- "id": 1,
- "completedBy": "Acme",
- "isCompleted": "true",
- "dateSent": "2025-07-01T16:45:55.246Z",
- "isManualUpload": "true",
- "responseId": 1,
- "title": "Vendor Security Questionnaire",
- "status": "SENT",
- "completedAt": "2025-07-01T16:45:55.246Z",
- "totalQuestions": 10,
- "totalQuestionsAnswered": 10,
- "reminderDate": "2025-07-01T16:45:55.246Z"
}
], - "pagination": {
- "cursor": "string",
- "totalCount": 0
}
}Upload a Security Questionnaire to a Vendor for a specific Security Review.
๐ Requires Vendors: Upload Security Questionnaire permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Created
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "id": 1,
- "completedBy": "Acme",
- "isCompleted": "true",
- "dateSent": "2025-07-01T16:45:55.246Z",
- "isManualUpload": "true",
- "responseId": 1,
- "title": "Vendor Security Questionnaire",
- "status": "SENT",
- "completedAt": "2025-07-01T16:45:55.246Z",
- "totalQuestions": 10,
- "totalQuestionsAnswered": 10,
- "reminderDate": "2025-07-01T16:45:55.246Z"
}List available actions for a security review based on its current state (e.g. Finalize, Reopen). Supported for all security review types (SECURITY, SOC_REPORT, UPLOAD_REPORT). SOC_REPORT reviews additionally require the linked vendor report review to pass readiness validation before Finalize is offered.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: List Security Review Actions permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Successful
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "data": [
- {
- "action": "finalize"
}
]
}Execute an action on a security review. Finalize marks the review as complete and records the reviewer decision (PENDING, APPROVED, APPROVED_WITH_CONDITIONS, or REJECTED); decision defaults to APPROVED when omitted, and PENDING completes the review without recording a conclusion. Reopen returns a completed review to in-progress and, when resetDecision is true, also clears the prior decision back to PENDING. Supported for all security review types (SECURITY, SOC_REPORT, UPLOAD_REPORT).
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Perform Security Review Action permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Successful
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
The requested action is not available for the current state of this security review.
Internal server error
{- "action": "finalize",
- "decision": "APPROVED",
- "note": "string",
- "resetDecision": true
}{- "success": true,
- "newStatus": "COMPLETED",
- "message": "Security review finalized successfully"
}Start the AI agent on an existing Security Review, or get the workflow id of the agent already running on it. Creating a SECURITY Security Review with POST /vendors/{vendorId}/security-reviews starts the agent automatically; call this endpoint afterwards to get the workflow id, or to start the agent if the automatic start failed. When the agent already runs on the review, the same workflow is returned and nothing new starts. The next step is to confirm the criteria. The work runs in the background: a 202 means it was accepted, not finished. Read the outcome through the Assessments endpoints.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Start Agent Review permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
The agent is running on the review.
Malformed data and/or validation errors
Invalid Authorization
The account lacks a TPRM plan.
The API key or OAuth token lacks the permission or scope, the user cannot access this Vendor, or the AI agent is not available: the account needs TPRM_AGENT, AI_DATA_SHARE and AI turned on, and the Security Review must be a SECURITY review.
The Security Review does not belong to the Vendor.
You must accept the Drata terms and conditions to use the API
Internal server error
{ }{- "securityReviewId": 1,
- "workflowId": 1
}Save the Vendor Criteria the agent assesses. Open only while the agent waits for criteria; otherwise it fails with 422. Send criterionIds to choose them; every ID must be a published criterion. Omit criterionIds to save the published criteria that match the Vendor impact level, inherent risk level and vendor type, the same set the Vendor Criteria list returns for the review. An empty array is rejected, and so is an empty default set. If access to the Vendor Trust Center was already granted, confirming can also start document collection.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Update Agent Review permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
The criteria were saved.
Malformed data and/or validation errors
Invalid Authorization
The account lacks a TPRM plan.
You are not allowed to perform this action
The Security Review does not belong to the Vendor, or has no agent review.
You must accept the Drata terms and conditions to use the API
Criteria confirmation is not open: the structured body with blockers and availableActions. A criterion is unknown or unpublished, or no default criteria match: the standard error body, with the reason in message.
Internal server error
{- "criterionIds": [
- 101,
- 102
]
}{- "securityReviewId": 1,
- "criterionIds": [
- 101,
- 102
], - "source": "default"
}Start the assessment, or re-run it when it already ran. Open once the criteria are confirmed and again after an assessment finishes; otherwise it fails with 422. The work runs in the background: a 202 means it was accepted, not finished. Read the outcome through the Assessments endpoints.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Update Agent Review permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
The assessment was accepted.
Malformed data and/or validation errors
Invalid Authorization
The account lacks a TPRM plan.
The API key or OAuth token lacks the permission or scope, the user cannot access this Vendor, or the AI agent is not available: the account needs TPRM_AGENT, AI_DATA_SHARE and AI turned on, and the Security Review must be a SECURITY review.
The Security Review does not belong to the Vendor, or has no agent review.
You must accept the Drata terms and conditions to use the API
The assessment cannot be started right now.
Internal server error
{ }{- "securityReviewId": 1,
- "workflowId": 1,
- "action": "start_assessment"
}Stop the assessment that is running or preparing. Open only while an assessment runs or prepares; otherwise it fails with 422. The run ends as cancelled and nothing already recorded is deleted. Start or re-run the assessment again with POST .../assessment-runs. The work runs in the background: a 202 means it was accepted, not finished. Read the outcome through the Assessments endpoints.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Update Agent Review permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
The stop was accepted.
Malformed data and/or validation errors
Invalid Authorization
The account lacks a TPRM plan.
The API key or OAuth token lacks the permission or scope, the user cannot access this Vendor, or the AI agent is not available: the account needs TPRM_AGENT, AI_DATA_SHARE and AI turned on, and the Security Review must be a SECURITY review.
The Security Review does not belong to the Vendor, or has no agent review.
You must accept the Drata terms and conditions to use the API
No assessment is running or preparing.
Internal server error
{ }{- "securityReviewId": 1,
- "workflowId": 1,
- "action": "start_assessment"
}Generate the follow-up questionnaire for the criteria the assessment did not meet. Open after an assessment finishes; otherwise it fails with 422. When every criterion was met, nothing is generated. Once generated, it can be regenerated only if a criterion result changed since then and the questionnaire was not sent: calling it again then replaces the questions of the draft, including any edits made to it in the Drata app. Otherwise a second call fails with 422. Once it is sent, a new one comes from re-running the assessment. The work runs in the background: a 202 means it was accepted, not finished. Read the outcome through the Assessments endpoints.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Update Agent Review permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
The generation was accepted.
Malformed data and/or validation errors
Invalid Authorization
The account lacks a TPRM plan.
The API key or OAuth token lacks the permission or scope, the user cannot access this Vendor, or the AI agent is not available: the account needs TPRM_AGENT, AI_DATA_SHARE and AI turned on, and the Security Review must be a SECURITY review.
The Security Review does not belong to the Vendor, or has no agent review.
You must accept the Drata terms and conditions to use the API
The follow-up questionnaire cannot be generated right now.
Internal server error
{ }{- "securityReviewId": 1,
- "workflowId": 1,
- "action": "start_assessment"
}Read the latest observation suggestions of the Security Review and their status. It has no side effects. stale is true when the assessment gaps changed after the suggestions were drafted.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: List Vendors permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
The latest observation suggestions.
Invalid Authorization
The account lacks a TPRM plan.
The API key or OAuth token lacks the permission or scope, the user cannot access this Vendor, or the AI agent is not available: the account needs TPRM_AGENT, AI_DATA_SHARE and AI turned on, and the Security Review must be a SECURITY review.
The Security Review does not belong to the Vendor.
You must accept the Drata terms and conditions to use the API
Internal server error
{- "securityReviewId": 1,
- "generationId": "3452dda5-3010-4348-849d-ce0345c111b3",
- "status": "COMPLETED",
- "requestedAt": "2025-07-01T16:45:55.246Z",
- "generatedAt": "2025-07-01T16:45:55.246Z",
- "stale": false,
- "omittedGapCount": 0,
- "suggestions": [
- {
- "id": 1,
- "observation": "The SOC 2 report does not cover encryption at rest. Ask the Vendor for its data encryption policy.",
- "source": "SOC 2 Type II Report.pdf",
- "vendorAssessmentId": 345,
- "criterionName": "Encryption at rest"
}
]
}Draft observations for the gaps of the assessment: the criteria whose current status is not met, inconclusive or partially met. Open after the assessment completed and its residual risk was reviewed, while the review is not finalized and has gaps; otherwise it fails with 422. While a draft is running, calling it again returns the same generation; once it completed, calling it again returns that generation until the gaps change. Read the suggestions with GET .../observation-suggestions. Nothing is saved to the review: save a suggestion with POST .../observations, passing its vendorAssessmentId.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Update Agent Review permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
The generation was accepted, one is already running, or the completed one still matches the gaps.
Malformed data and/or validation errors
Invalid Authorization
The account lacks a TPRM plan.
The API key or OAuth token lacks the permission or scope, the user cannot access this Vendor, or the AI agent is not available: the account needs TPRM_AGENT, AI_DATA_SHARE and AI turned on, and the Security Review must be a SECURITY review.
The Security Review does not belong to the Vendor, or has no agent review.
You must accept the Drata terms and conditions to use the API
Observations cannot be suggested right now.
Internal server error
{ }{- "securityReviewId": 1,
- "generationId": "3452dda5-3010-4348-849d-ce0345c111b3",
- "status": "RUNNING"
}Read the follow-up questionnaire the agent generated for the Security Review: its status and questions. It has no side effects. Fails with 404 when no follow-up questionnaire was generated; generate it with POST .../follow-up-questionnaires.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: List Vendors permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
The follow-up questionnaire.
Invalid Authorization
The account lacks a TPRM plan.
The API key or OAuth token lacks the permission or scope, the user cannot access this Vendor, or the AI agent is not available: the account needs TPRM_AGENT, AI_DATA_SHARE and AI turned on, and the Security Review must be a SECURITY review.
The Security Review does not belong to the Vendor, has no agent review, or has no follow-up questionnaire.
You must accept the Drata terms and conditions to use the API
Internal server error
{- "securityReviewId": 1,
- "workflowId": 1,
- "followUpQuestionnaire": {
- "id": 1,
- "name": "Vendor Assessment Follow-Up - Review 123",
- "status": "DRAFT"
}, - "questions": [
- {
- "id": 1,
- "question": "Do you encrypt data at rest?",
- "type": "SHORT_ANSWER",
- "required": true,
- "criterionName": "Encryption at rest"
}
]
}Email the Vendor a link to the follow-up questionnaire of this Security Review. The questionnaire is the draft the agent generated; it cannot be chosen. Open after the follow-up questionnaire was generated and before it is sent; otherwise it fails with 422. The email is sent in the background: a 202 means it was accepted, not delivered. The Vendor receives a Vendor Hub link. When the Vendor answers, the agent re-runs the assessment automatically. When emailContent is omitted the default message of the email template is used.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Update Agent Review permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
The send was accepted.
Malformed data and/or validation errors
Invalid Authorization
The account lacks a TPRM plan.
The API key or OAuth token lacks the permission or scope, the user cannot access this Vendor, or the AI agent is not available: the account needs TPRM_AGENT, AI_DATA_SHARE and AI turned on, and the Security Review must be a SECURITY review.
The Security Review does not belong to the Vendor, has no agent review, or has no follow-up questionnaire.
You must accept the Drata terms and conditions to use the API
The follow-up questionnaire cannot be sent right now: the structured body with blockers and availableActions. The questionnaire is no longer a draft: the standard error body, with the reason in message.
Internal server error
{- "emailSubject": "Drata is conducting a security review of you.",
- "emailContent": "Hi,\n\nWe'd like to conduct a security review and would like some information from you. Use this link to complete the questionnaire.\n\nThank you."
}{- "securityReviewId": 1,
- "workflowId": 1,
- "action": "start_assessment"
}Complete the Security Review with a decision. Open only after the assessment completed and the residual risk was reviewed; otherwise it fails with 422. It marks the review completed with the decision and the optional note, and generates the executive summary in the background. The agent's "Finalize review and generate report" step completes asynchronously and best-effort after this call returns. The decision is required: there is no default decision, unlike the base-tier Security Review actions endpoint, which defaults to APPROVED. Fails with 400 when the review is already completed.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Update Agent Review permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
The Security Review was finalized.
Malformed data and/or validation errors
Invalid Authorization
The account lacks a TPRM plan.
The API key or OAuth token lacks the permission or scope, the user cannot access this Vendor, or the AI agent is not available: the account needs TPRM_AGENT, AI_DATA_SHARE and AI turned on, and the Security Review must be a SECURITY review.
The Security Review does not belong to the Vendor, or has no agent review.
You must accept the Drata terms and conditions to use the API
The agent does not offer the finalize action right now.
Internal server error
{- "decision": "APPROVED",
- "note": "string"
}{- "securityReviewId": 1,
- "workflowId": 1,
- "action": "finalize",
- "decision": "APPROVED"
}Upload documents to a Security Review and notify its agent, so the next assessment run uses them. Use this endpoint, not the Vendor Documents upload, for a review the agent works on: only this one notifies the agent. Open whenever an agent review exists on the Security Review, whatever the agent is doing, so it can also unblock a review that stalled for lack of documents. Send 10 files at most as multipart/form-data in files, and optionally a type applied to all of them. Every file is validated and scanned before any is stored: when one is rejected, none is added. Fails with 404 when the Security Review has no agent review. Adding documents does not start an assessment; start or re-run it through the Assessment Runs endpoint.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Update Agent Review permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
The documents were added and the agent was notified.
Malformed data and/or validation errors
Invalid Authorization
The account lacks a TPRM plan.
The API key or OAuth token lacks the permission or scope, the user cannot access this Vendor, or the AI agent is not available: the account needs TPRM_AGENT, AI_DATA_SHARE and AI turned on, and the Security Review must be a SECURITY review.
The Security Review does not belong to the Vendor, or has no agent review.
You must accept the Drata terms and conditions to use the API
The file was too large to upload
Internal server error
{- "securityReviewId": 1,
- "workflowId": 1,
- "documents": [
- {
- "id": 1,
- "name": "AWS SOC 2 2025",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "type": "COMPLIANCE_REPORT",
- "downloadUrl": {
- "fileBuffer": {
- "buffer": "RXhhbXBsZSB0ZXh0IGNvbnRlbnQ="
}, - "fileName": "Artifact 3.png"
}
}
]
}Collect the documents the Vendor publishes on its Trust Center, which need no access, and assess them once the criteria are confirmed. Open while the Vendor has a supported Trust Center, access was not granted and no collection or assessment is underway; otherwise it fails with 422. To collect the private documents too, request access with POST .../access-requests. The work runs in the background: a 202 means it was accepted, not finished. Read the outcome through the Assessments endpoints.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Update Agent Review permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
The collection was accepted.
Malformed data and/or validation errors
Invalid Authorization
The account lacks a TPRM plan.
The API key or OAuth token lacks the permission or scope, the user cannot access this Vendor, or the AI agent is not available: the account needs TPRM_AGENT, AI_DATA_SHARE and AI turned on, and the Security Review must be a SECURITY review.
The Security Review does not belong to the Vendor, or has no agent review.
You must accept the Drata terms and conditions to use the API
Public documents cannot be collected right now.
Internal server error
{ }{- "securityReviewId": 1,
- "workflowId": 1,
- "action": "start_assessment"
}Read the form the Vendor Trust Center asks to fill in to request access, to send with POST .../access-requests. It has no side effects. Open while the agent offers to request access; otherwise it fails with 422. The form describes the user the API key or OAuth token acts as, because the request is made in their name.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: List Vendors permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
The access request form.
Invalid Authorization
The account lacks a TPRM plan.
The API key or OAuth token lacks the permission or scope, or the user cannot access this Vendor.
The Security Review does not belong to the Vendor, has no agent review, or its agent review is no longer running.
The agent review is authenticated against the Trust Center as a different user.
You must accept the Drata terms and conditions to use the API
The agent does not offer to request access right now.
Internal server error
The Vendor Trust Center failed or did not answer. Nothing was changed.
{- "securityReviewId": 1,
- "workflowId": 1,
- "memberLoginStatusCode": "email_not_recognized",
- "fields": [
- {
- "name": "firstName",
- "label": "First name",
- "type": "text",
- "required": true,
- "minLength": 1,
- "maxLength": 64,
- "options": [
- {
- "value": "customer",
- "label": "Customer"
}
],
}
]
}Ask the Vendor for access to the private documents of its Trust Center, so the agent collects them once access is granted. Open while the agent offers to request access; otherwise it fails with 422. The agent review is authenticated as the user the API key or OAuth token acts as. For a SafeBase Trust Center the request carries that user's email and the fields sent. For any other Trust Center the agent fills in the Vendor form with the fields sent, and uses the email of the user who created the review unless workEmail is sent. Read the fields with GET .../access-request-requirements. If the Trust Center rejects the request, nothing is kept, so it can be sent again. The work runs in the background: a 202 means it was accepted, not finished. Read the outcome through the Assessments endpoints.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Update Agent Review permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
object <= 50 properties The access request form, by field name. Read the names, types and required fields from GET .../access-request-requirements. A checkbox takes a boolean, a select takes one of its options' |
The access request was sent.
Malformed data and/or validation errors
Invalid Authorization
The account lacks a TPRM plan.
The API key or OAuth token lacks the permission or scope, or the user cannot access this Vendor.
The Security Review does not belong to the Vendor, has no agent review, or its agent review is no longer running.
The agent review is authenticated against the Trust Center as a different user.
You must accept the Drata terms and conditions to use the API
The agent does not offer to request access right now.
Internal server error
The Vendor Trust Center failed or did not answer. Nothing was changed.
{- "fields": {
- "firstName": "Jane",
- "lastName": "Doe",
- "companyName": "Acme Corporation",
- "agreeToTerms": true
}
}{- "securityReviewId": 1,
- "workflowId": 1,
- "action": "start_assessment"
}Give the agent a link that opens the Vendor Trust Center documents, such as one the Vendor shared, so it collects them without an access request. Open while the agent offers it: the Trust Center is not a SafeBase one, access was not granted and no collection is underway; otherwise it fails with 422. The link must open the Vendor Trust Center (its own host) or a known Trust Center platform, and resolve to public addresses only. It needs the AI agent, like the other steps that make the agent collect documents. The agent review stays authenticated as the user the API key or OAuth token acts as. The work runs in the background: a 202 means it was accepted, not finished. Read the outcome through the Assessments endpoints.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Update Agent Review permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
The access link was accepted.
The body is invalid, or the access link does not open the Vendor Trust Center or a known Trust Center platform on a public address.
Invalid Authorization
The account lacks a TPRM plan.
The API key or OAuth token lacks the permission or scope, the user cannot access this Vendor, or the AI agent is not available: the account needs TPRM_AGENT, AI_DATA_SHARE and AI turned on, and the Security Review must be a SECURITY review.
The Security Review does not belong to the Vendor, has no agent review, or its agent review is no longer running.
The agent review is authenticated against the Trust Center as a different user.
You must accept the Drata terms and conditions to use the API
The agent does not accept an access link right now.
Internal server error
{
}{- "securityReviewId": 1,
- "workflowId": 1,
- "action": "start_assessment"
}Stop waiting on a Trust Center access request that is still pending, so documents can be uploaded with POST .../documents. The request itself stays open: if the Vendor grants access later, the agent still collects the documents. Open only while an access request is pending; otherwise it fails with 422. POST .../access-requests undoes the skip whenever the agent offers it again, which it does while the review is not authenticated against the Trust Center (a request made through this API authenticates it). The work runs in the background: a 202 means it was accepted, not finished. Read the outcome through the Assessments endpoints.
๐งช Note: This endpoint is in beta and may change.
๐ Requires Vendors: Update Agent Review permission.
๐ Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
The skip was accepted.
Malformed data and/or validation errors
Invalid Authorization
The account lacks a TPRM plan.
The API key or OAuth token lacks the permission or scope, or the user cannot access this Vendor.
The Security Review does not belong to the Vendor, or has no agent review.
You must accept the Drata terms and conditions to use the API
No access request is pending.
Internal server error
{ }{- "securityReviewId": 1,
- "workflowId": 1,
- "action": "start_assessment"
}