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.
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.
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.
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.
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"
}
}