Skip to content
Templated API Documentation Templated API Documentation

Merge renders

Merges multiple renders into a single PDF.
A merge uses 1 API credit.
The merged PDF will be returned directly in the response and will not be stored in your account.

Parameters

ids array REQUIRED The render ids of the renders that will be merged.

Sample Request

Here’s a sample request to merge renders:

ENDPOINT
POST /v1/render/merge
REQUEST
fetch("https://api.templated.io/v1/render/merge", {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${API_KEY}`
  },
  body: JSON.stringify({
    ids: [
      "render_id_1",
      "render_id_2",
      "render_id_3"
    ]
  })
})
.then(response => response.blob())
.then(blob => {
  // Handling the response
  const url = window.URL.createObjectURL(blob);
  const link = document.createElement('a');
  link.href = url;
  link.download = 'merged_renders.pdf'; // Set the download filename


  // Trigger the download
  document.body.appendChild(link);
  link.click();
});

Response

The API returns the merged PDF file directly in the response body with the following headers:

  • Content-Type: application/pdf
  • Content-Disposition: attachment; filename="merged_renders.pdf"

The PDF file can be downloaded and saved directly from the response.

Note: Unlike other endpoints that return JSON, this endpoint streams the PDF binary data directly.