Documentation Index
Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
Use this file to discover all available pages before exploring further.
DELETE /v1/files/{file_id}
Permanently deletes a file by ID. This operation is irreversible.
Path parameters
| Parameter | Type | Required | Description |
|---|
file_id | string | Yes | File unique identifier with the file_ prefix |
| Header | Required | Description |
|---|
Authorization | Yes | Bearer $QODER_PAT |
Example request
curl -X DELETE "https://openapi.qoder.sh/api/v1/cloud/files/file_019e3bb8e4b67b7789e49ca6ecb2aae0" \
-H "Authorization: Bearer $QODER_PAT"
Example response
HTTP 204 No Content
A successful delete returns HTTP 204 with no response body.
Errors
| HTTP | Type | Trigger |
|---|
| 401 | – | Missing or invalid authentication token |
| 404 | not_found_error | File with the given ID does not exist |
Error response example
{
"error": {
"message": "File 'file_nonexistent123' was not found.",
"type": "not_found_error"
},
"type": "error"
}
Notes
- Deletion is permanent and cannot be undone.
- After deletion, the list endpoint no longer returns the file.
- If the file is referenced by an active session, the reference becomes invalid after deletion.
See Errors for the full error envelope.
