> ## Documentation Index
> Fetch the complete documentation index at: https://alliancebioversityciat-alliance-risk-analysis-tool.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete assessment

Permanently delete an assessment and all related data.

> [!WARNING]
>
> 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.

```bash cURL theme={null}
curl -X DELETE https://api.example.com/api/assessments/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_TOKEN"
```

```javascript JavaScript theme={null}
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');
}
```

```python Python theme={null}
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')
```

```text 204 No Content theme={null}
(empty response body)
```

```json 404 Not Found theme={null}
{
  "statusCode": 404,
  "message": "Assessment not found",
  "error": "Not Found"
}
```

```json 403 Forbidden theme={null}
{
  "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)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.