Skip to content

Delete one or multiple uploads by their IDs. All specified uploads must exist and belong to your account for the deletion to proceed.

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));

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)"
}
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"}
  • 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.
ParameterTypeRequiredDescription
idsstring[]YesOne or more upload IDs to delete. Pass multiple ids parameters for bulk deletion.