Skip to content

Delete a specific render by its ID.

Deleting is permanent. We delete the rendered file from our storage, the request data sent to create the render (layers, URLs and other parameters) and the render record. It can’t be undone, and the render URL stops working. Credits used by the render are not refunded. If you use Bring Your Own Storage, the copy in your own bucket is yours and isn’t touched.

Here’s a sample request to delete a render:

ENDPOINT
DELETE /v1/render/{id}
fetch(`https://api.templated.io/v1/render/${RENDER_ID}`, {
method: 'DELETE',
headers: {
'Authorization': `Bearer ${API_KEY}`
}
})
.then(response => {
if (response.status === 204) {
console.log('Render deleted successfully');
}
})
.catch(error => console.error('Error:', error));

A successful deletion will return a 204 No Content response with no body.

Status CodeDescription
401Not authorized - Invalid or missing API key
403Forbidden - You don’t have permission to delete this render
404Not Found - Render or user not found
409Conflict - The render is still being generated. Delete it after it completes
500Internal Server Error - An unexpected error occurred