Renders
Every novem e-mail renders to more than HTML. Fetch it as plain text, colored terminal output, PDF, PNG, or PowerPoint, from the files folder or through the compact /u/ short links.
AI assisted, human approved — novem uses AI to review and keep our documentation up to date.
The same content that goes out as an e-mail can be fetched in a range of formats. See the files reference for the general philosophy. This page lists what's available for e-mails specifically.
Authenticated renders live in the e-mail's files/ folder:
| Path | Format |
|---|---|
/v1/vis/mails/:mail/files/mail.txt | Plain text |
/v1/vis/mails/:mail/files/mail.ansi | 256-color terminal output |
/v1/vis/mails/:mail/files/mail.pdf | |
/v1/vis/mails/:mail/files/mail.png | PNG image |
/v1/vis/mails/:mail/files/mail.pptx | PowerPoint |
The txt and ansi renders accept cols and rows query parameters to
control the terminal geometry, e.g. mail.ansi?cols=120.
Each e-mail is also reachable under the compact /v1/u/:user/m/:mail form.
These endpoints honour the e-mail's sharing settings (its shared/ folder):
anyone with read access can fetch them, and a publicly shared e-mail needs no
authentication at all.
| Path | Returns |
|---|---|
/v1/u/:user/m | JSON list of the user's e-mails visible to you |
/v1/u/:user/m/:mail | JSON metadata for the e-mail |
/v1/u/:user/m/:mail/txt | Plain text render |
/v1/u/:user/m/:mail/ansi | Terminal (ansi) render |
/v1/u/:user/m/:mail/txt/html | The text render wrapped as an HTML page |
/v1/u/:user/m/:mail/ansi/html | The ansi render wrapped as an HTML page |
/v1/u/:user/m/:mail/img | PNG image render |
/v1/u/:user/m/:mail/txt/html/img | PNG image of the text view |
/v1/u/:user/m/:mail/ansi/html/img | PNG image of the ansi view |
/v1/u/:user/m/:mail/pdf | PDF render |
/v1/u/:user/m/:mail/pptx | PowerPoint render |
As with the files folder, the txt and ansi variants accept cols and
rows query parameters.
An e-mail's vars get the same public treatment:
| Path | Returns |
|---|---|
/v1/u/:user/m/:mail/v | JSON list of the e-mail's vars |
/v1/u/:user/m/:mail/v/:var | JSON detail for one var |
/v1/u/:user/m/:mail/v/:var/txt | The var's formatted plain-text output |
/v1/u/:user/m/:mail/v/:var/ansi | The var's formatted terminal output |
Note: renders are produced on demand and cached. The first request after a content change can take a moment. Repeat fetches are fast.