Skip to main content

Remote HTTP

A directory containing template.http.hbs is a remote template: it renders a raw HTTP request from a Handlebars template, executes it, and returns the response body as the output. This is covered in depth — including the important security considerations — in Remote templates.

GET {{documentUrl}} HTTP/1.1
Host: {{host}}
Accept: application/pdf

Key points:

  • The response body (typically a PDF) becomes the render output.
  • A response status > 299 is treated as an error.
  • Most useful inside compositions (see the remote-merge example).

Only build remote requests from trusted data. Untrusted data in the URL or headers is an SSRF/header-injection risk. See Remote templates → Security.