curl -X DELETE https://api.example.com/api/assessments/550e8400-e29b-41d4-a716-446655440000 \
-H "Authorization: Bearer YOUR_TOKEN"
const assessmentId = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(
`https://api.example.com/api/assessments/${assessmentId}`,
{
method: 'DELETE',
headers: { 'Authorization': 'Bearer YOUR_TOKEN' }
}
);
if (response.status === 204) {
console.log('Assessment deleted successfully');
}
import requests
assessment_id = '550e8400-e29b-41d4-a716-446655440000'
response = requests.delete(
f'https://api.example.com/api/assessments/{assessment_id}',
headers={'Authorization': 'Bearer YOUR_TOKEN'}
)
if response.status_code == 204:
print('Assessment deleted successfully')
(empty response body)
{
"statusCode": 404,
"message": "Assessment not found",
"error": "Not Found"
}
{
"statusCode": 403,
"message": "Access denied",
"error": "Forbidden"
}
Assessments
Delete assessment
DELETE
/
api
/
assessments
/
:id
curl -X DELETE https://api.example.com/api/assessments/550e8400-e29b-41d4-a716-446655440000 \
-H "Authorization: Bearer YOUR_TOKEN"
const assessmentId = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(
`https://api.example.com/api/assessments/${assessmentId}`,
{
method: 'DELETE',
headers: { 'Authorization': 'Bearer YOUR_TOKEN' }
}
);
if (response.status === 204) {
console.log('Assessment deleted successfully');
}
import requests
assessment_id = '550e8400-e29b-41d4-a716-446655440000'
response = requests.delete(
f'https://api.example.com/api/assessments/{assessment_id}',
headers={'Authorization': 'Bearer YOUR_TOKEN'}
)
if response.status_code == 204:
print('Assessment deleted successfully')
(empty response body)
{
"statusCode": 404,
"message": "Assessment not found",
"error": "Not Found"
}
{
"statusCode": 403,
"message": "Access denied",
"error": "Forbidden"
}
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
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"
const assessmentId = '550e8400-e29b-41d4-a716-446655440000';
const response = await fetch(
`https://api.example.com/api/assessments/${assessmentId}`,
{
method: 'DELETE',
headers: { 'Authorization': 'Bearer YOUR_TOKEN' }
}
);
if (response.status === 204) {
console.log('Assessment deleted successfully');
}
import requests
assessment_id = '550e8400-e29b-41d4-a716-446655440000'
response = requests.delete(
f'https://api.example.com/api/assessments/{assessment_id}',
headers={'Authorization': 'Bearer YOUR_TOKEN'}
)
if response.status_code == 204:
print('Assessment deleted successfully')
(empty response body)
{
"statusCode": 404,
"message": "Assessment not found",
"error": "Not Found"
}
{
"statusCode": 403,
"message": "Access denied",
"error": "Forbidden"
}
Related data deletion
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)
⌘I