Delete uploads
Delete one or multiple uploads by their IDs. All specified uploads must exist and belong to your account for the deletion to proceed.
Sample Request
Here’s a sample request to delete uploads:
DELETE /v1/uploads?ids=UPLOAD_ID_1&ids=UPLOAD_ID_2
// Delete single uploadfetch(`https://api.templated.io/v1/uploads?ids=${UPLOAD_ID_1}`, { method: 'DELETE', headers: { 'Authorization': `Bearer ${API_KEY}` }}).then(response => response.json()).then(data => console.log('Response:', data)).catch(error => console.error('Error:', error));
// Delete multiple uploadsconst uploadIds = [UPLOAD_ID_1, UPLOAD_ID_2];const params = uploadIds.map(id => `ids=${id}`).join('&');
fetch(`https://api.templated.io/v1/uploads?${params}`, { method: 'DELETE', headers: { 'Authorization': `Bearer ${API_KEY}` }}).then(response => response.json()).then(data => console.log('Response:', data)).catch(error => console.error('Error:', error));
import requests
api_key = 'API_KEY'upload_ids = ['UPLOAD_ID_1', 'UPLOAD_ID_2']
# Prepare query parametersparams = {'ids': upload_ids}url = 'https://api.templated.io/v1/uploads'headers = {'Authorization': f'Bearer {api_key}'}
response = requests.delete(url, headers=headers, params=params)
if response.status_code == 200: result = response.json() print(f"Successfully deleted: {result['deleted']}") print(result['message'])else: print('Request failed. Response code:', response.status_code) print(response.text)
import java.net.HttpURLConnection;import java.net.URL;import java.net.URLEncoder;import java.io.BufferedReader;import java.io.InputStreamReader;
public class DeleteUploads { public static void main(String[] args) { try { String apiKey = "API_KEY"; String[] uploadIds = {"UPLOAD_ID_1", "UPLOAD_ID_2"};
// Build query parameters StringBuilder params = new StringBuilder(); for (int i = 0; i < uploadIds.length; i++) { if (i > 0) params.append("&"); params.append("ids=").append(URLEncoder.encode(uploadIds[i], "UTF-8")); }
URL url = new URL("https://api.templated.io/v1/uploads?" + params.toString());
HttpURLConnection connection = (HttpURLConnection) url.openConnection(); connection.setRequestMethod("DELETE"); connection.setRequestProperty("Authorization", "Bearer " + apiKey);
int responseCode = connection.getResponseCode(); if (responseCode == HttpURLConnection.HTTP_OK) { BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream())); String response = reader.readLine(); System.out.println("Response: " + response); } else { System.out.println("Request failed. Response Code: " + responseCode); } } catch (Exception e) { e.printStackTrace(); } }}
<?php$apiKey = 'API_KEY';$uploadIds = ['UPLOAD_ID_1', 'UPLOAD_ID_2'];
// Build query parameters$params = http_build_query(['ids' => $uploadIds]);$url = "https://api.templated.io/v1/uploads?{$params}";
$options = [ 'http' => [ 'header' => "Authorization: Bearer {$apiKey}\r\n", 'method' => 'DELETE' ]];
$context = stream_context_create($options);$result = file_get_contents($url, false, $context);
if ($result !== false) { $response = json_decode($result, true); echo "Successfully deleted: " . implode(', ', $response['deleted']) . "\n"; echo $response['message'] . "\n";} else { echo "Error deleting uploads\n";}?>
Response
Success Response
A successful deletion will return a 200 OK
response with details about the deleted uploads:
{ "deleted": ["upload-id-1", "upload-id-2"], "message": "Successfully deleted 2 upload(s)"}
Error Responses
Status Code | Description | Response Body |
---|---|---|
400 | Bad Request - Invalid upload IDs or permission issues | {"not_found": ["id1"], "unauthorized": ["id2"], "error": "Cannot delete uploads: some uploads were not found or you don't have permission to delete them"} |
400 | Bad Request - No upload IDs provided | {"error": "At least one upload ID must be provided"} |
401 | Not authorized - Invalid or missing API key | {"error": "Not authorized"} |
404 | Not Found - User not found | {"error": "User not found"} |
500 | Internal Server Error - An unexpected error occurred | {"error": "An unexpected error occurred"} |
Important Notes
- Atomic Operation: Either all specified uploads are deleted, or none are deleted. If any upload ID is invalid or unauthorized, the entire operation fails.
- Bulk Support: You can delete multiple uploads in a single request by passing multiple
ids
parameters.
Query Parameters
Parameter | Type | Required | Description |
---|---|---|---|
ids | string[] | Yes | One or more upload IDs to delete. Pass multiple ids parameters for bulk deletion. |