Permanently and irreversibly deletes a file by its ID.
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
|
|
string | Yes | The unique file identifier, prefixed with |
Request headers
| Header | Required | Description |
|---|---|---|
|
|
Yes |
|
Example request
curl -X DELETE "https://api.qoder.com.cn/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 |
|
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.