Skip to main content
DELETE
/
api
/
assessments
/
:id
curl -X DELETE https://api.example.com/api/assessments/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_TOKEN"
(empty response body)
Permanently delete an assessment and all related data.
This operation is irreversible. All associated documents, gap fields, risk scores, recommendations, and comments will be permanently deleted.

Path parameters

id
string
required
Assessment ID (UUID).

Response

Returns a 204 No Content status on successful deletion.
curl -X DELETE https://api.example.com/api/assessments/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_TOKEN"
(empty response body)
Deleting an assessment cascades to:
  • Documents - All uploaded files and their S3 objects
  • Gap fields - Missing or partial data points identified during analysis
  • Risk scores - Calculated scores for all 7 risk categories
  • Recommendations - AI-generated and user-edited recommendations
  • Comments - All user comments on the assessment
  • Interview answers - Responses from guided interviews (if applicable)
  • Data entries - Manual data entries (if applicable)

Build docs developers (and LLMs) love