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