Remove Download

​

Path Parameters

​

Response

​

Example Request

curl -X DELETE https://your-api.com/api/downloads/550e8400-e29b-41d4-a716-446655440000/remove

fetch('https://your-api.com/api/downloads/550e8400-e29b-41d4-a716-446655440000/remove', {
  method: 'DELETE'
})
  .then(response => response.json())
  .then(data => console.log(data.message));

import requests

download_id = "550e8400-e29b-41d4-a716-446655440000"
response = requests.delete(f"https://your-api.com/api/downloads/{download_id}/remove")
print(response.json())

​

Example Response

{
  "message": "Descarga eliminada"
}

​

Error Responses

​

404 Not Found

{
  "detail": "Descarga no encontrada"
}

​

Behavior

1. Removes the task from the in-memory downloads dictionary
2. Deletes the video/audio file from the downloads directory (if it exists)
3. Deletes the thumbnail from the thumbnails directory (checks for .jpg, .webp, and .png extensions)
4. Returns confirmation message

​

Files Deleted

# Video/audio file
/downloads/{title}__{download_id}.{ext}

# Thumbnail files (all formats checked)
/thumbnails/{download_id}.jpg
/thumbnails/{download_id}.webp
/thumbnails/{download_id}.png

​

After Removal

• The task will no longer appear in GET /api/downloads
• Attempting to access GET /api/download//file will return 404
• All disk space used by the download is freed

​

Cancel vs Remove

​

Use Cases

• Free up disk space: Remove completed downloads that are no longer needed
• Clean up failed downloads: Remove tasks with status "error"
• Clear download history: Remove old downloads from the list
• Delete unwanted files: Remove downloads that were completed but no longer wanted

​

Error Handling

• The video/audio file doesn’t exist
• The thumbnail file doesn’t exist
• Files were already manually deleted

# From source code
(DOWNLOAD_DIR / task.filename).unlink(missing_ok=True)
(THUMBNAILS_DIR / f"{download_id}.{ext}").unlink(missing_ok=True)