One of a template’s documents, filled in with your values, as it would be sealed.

SEE A BINDING BEFORE YOU SEND IT. Takes the values and subjects you would send to POST /api/v1/envelopes for this template and answers with one of its documents as a PDF, every value drawn exactly as the sealed copy would draw it — a value split across printed boxes one character per cell, a date in the form the field prints, the option of a question ticked, long text wrapped in its box — and PREVIEW across every page. Nothing is stored, sent, recorded or billed, and there is no envelope and nobody to sign.

⚠️ A PREVIEW THAT RENDERS IS ONE THE SEND WOULD ACCEPT. The values are judged by the same check as POST /api/v1/templates/{templateId}/validate-values and create, and the first one create would refuse is refused here with create’s code and create’s message — ask validate-values for every entry’s verdict at once. A template_etag that is no longer current is refused template_changed, as create refuses it. The send’s own checks on the answers it would fix are asked too, of every document of the template, and refused with the send’s code and sentence: a locked, required box left empty (locked_answer_missing), or a locked answer its own box refuses (locked_answer_unusable) — the template’s own fixed answers included. It also refuses, with cannot_be_drawn, a value too long for its box even at the smallest size the sealed copy prints: create accepts that value, and the envelope would then fail to seal after every signature.

⚠️ THERE ARE NO RECIPIENTS, SO EVERY ROLE IS DRAWN AS IF IT IS ON THE ENVELOPE, held by one person — an optional role included, so you see the whole form. For the send’s checks your values stand in for the recipients: an optional role is on the envelope when one of them fills one of its boxes, and left out otherwise, as a send leaves out an optional role nobody is named for; a left-out role’s boxes are drawn but not checked, and leaving out a role whose box decides another role’s box is refused as the send refuses it. A title or company box filled from a recipient’s details is neither drawn nor checked here.

Boxes nobody gave a value stay blank, except an answer the template fixes itself. Boxes filled by signing — a signature, initials, the date of signing, the signer’s name and email — show whose they are, as Signature: Employee.

document is the 1-based position of the document in documents on GET /api/v1/templates/{templateId}, and is required when the template holds more than one.

⚠️ IT IS A RENDER, AND IT SHARES A CEILING. Each preview that renders counts against your organisation’s per-minute ceiling on renders, which draft renders (GET /api/v1/envelopes/{envelopeId}/documents/{position}/draft) count against too; past it the answer is rate_limited with Retry-After. ⚠️ EVERY REQUEST PAST THE CREDENTIAL AND BODY CHECKS IS COUNTED, before the template is read — one refused for a value or a stale etag, and a rate_limited one, included. To check values without spending the ceiling, use validate-values, which renders nothing.

⚠️ IT NEEDS documents:read AS WELL AS templates:read (x-additional-required-scopes): what it answers with is the template’s document itself, which templates:read alone never grants. A key missing either is refused insufficient_scope.

A test key and a live key get the same answer: a template has no environment. It is a POST only because the body can be large, and takes no Idempotency-Key.