Delete File
Delete a configuration file permanently. This action cannot be undone.
Endpoint
DELETE /{envId}/file/{id}
Authentication
Required: Yes (Session or Bearer Token with 2FA)
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
envId | string (UUID) | Yes | Environment ID containing the file |
id | string (UUID) | Yes | File ID to delete |
Response
Success Response (200 OK)
{
"message": "File deleted successfully",
"id": "file-550e8400-e29b-41d4-a716-446655440000"
}
Error Responses
| Status Code | Description |
|---|---|
| 400 | Bad Request - File is in use by applications or invalid UUID |
| 401 | Unauthorized - Invalid or missing authentication |
| 403 | Forbidden - User doesn't have access to this file |
| 404 | Not Found - File or environment doesn't exist |
| 500 | Internal Server Error |
Examples
curl -X DELETE "https://api.thevenin.cloud/api/v1/{envId}/file/{fileId}" \
-H "Authorization: Bearer tvn_your_api_token_here"