Skip to content
HALOWERK

Formatwerk

mailbox archive

Splits at "From " separator lines that follow an empty line, removes one ">" from escaped ">From " lines (mboxrd, default) or only from ">From " (mboxo), keeps every message byte-exact otherwise and stores it as messages/NNNNNN.eml. Headers are decoded with the same MIME parser as eml-to-pdf (RFC 2047/2231). Duplicates are detected by Message-ID and by content hash. The ZIP contains index.csv, index.json and manifest-sha256.txt (sha256sum format over all archive files); with include_pdf.

POST https://format.halowerk.com/v1/mailbox-archive

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
mboxstringNoMBOX text.
mbox_base64stringNoMBOX as base64 (for 8-bit content).
variantstringNoHow ">From " lines were escaped.
include_pdfbooleanNoRender each message as PDF (at most 50 messages).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "mbox": {
      "type": "string",
      "minLength": 10,
      "maxLength": 15000000,
      "description": "MBOX text."
    },
    "mbox_base64": {
      "type": "string",
      "minLength": 16,
      "maxLength": 20000000,
      "description": "MBOX as base64 (for 8-bit content)."
    },
    "variant": {
      "type": "string",
      "enum": [
        "mboxrd",
        "mboxo"
      ],
      "default": "mboxrd",
      "description": "How \">From \" lines were escaped."
    },
    "include_pdf": {
      "type": "boolean",
      "default": false,
      "description": "Render each message as PDF (at most 50 messages)."
    }
  }
}

Open original schema

Published input example

{
  "mbox": "From api@halowerk.com Mon Nov  2 09:00:00 2026\nFrom: api@halowerk.com\nSubject: Warehouse report\nDate: Mon, 02 Nov 2026 09:00:00 +0100\n\nHello\n"
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’