Skip to content

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:

ENDPOINT
DELETE /v1/uploads?ids=UPLOAD_ID_1&ids=UPLOAD_ID_2
// Delete single upload
fetch(`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 uploads
const 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));

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 CodeDescriptionResponse Body
400Bad 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"}
400Bad Request - No upload IDs provided{"error": "At least one upload ID must be provided"}
401Not authorized - Invalid or missing API key{"error": "Not authorized"}
404Not Found - User not found{"error": "User not found"}
500Internal 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

ParameterTypeRequiredDescription
idsstring[]YesOne or more upload IDs to delete. Pass multiple ids parameters for bulk deletion.