Risk Documents are supporting documents, evidence, or other materials that are associated with a risk.
Retrieve all Documents associated with a specific Risk.
🔒 Requires Risk Management: Get Risk Documents permission.
💎 Requires your account have the Risk Management Pro feature. Contact your CSM 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,
- "name": "Risk Assessment Document.pdf",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "pagination": {
- "cursor": "string"
}
}
Upload one or more Documents for a given Risk.
🔒 Requires Risk Management: Upload Risk Document permission.
💎 Requires your account have the Risk Management Pro feature. Contact your CSM for help upgrading.
Upload one or more Documents for the Risk
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
The file was too large to upload
Internal server error
Third party system was unavailable
{- "documents": [
- {
- "id": 1,
- "name": "Risk Assessment Document.pdf",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
]
}
Retrieve a specific Risk Document by its ID.
🔒 Requires Risk Management: Get Risk Documents permission.
💎 Requires your account have the Risk Management Pro feature. Contact your CSM 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,
- "name": "Risk Assessment Document.pdf",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
Delete a specific Risk Document using the provided Document ID.
🔒 Requires Risk Management: Delete Risk Document permission.
💎 Requires your account have the Risk Management Pro feature. Contact your CSM for help upgrading.
No Content
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
{- "name": "string",
- "statusCode": 0,
- "message": "string",
- "code": 0,
- "debugInfo": {
- "name": "string",
- "message": "string",
- "stack": "string"
}
}