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
Section titled “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
Section titled “Response”Success Response
Section titled “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
Section titled “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
Section titled “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
idsparameters.
Query Parameters
Section titled “Query Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
ids | string[] | Yes | One or more upload IDs to delete. Pass multiple ids parameters for bulk deletion. |