Overview

The Office Engine API is a transparent proxy to the standalone TypeScript Office engine service (services/office-engine). It parses and re-serializes Office documents without the gateway becoming a second source of document state. Both the legacy /api/office/* surface and the converged /api/v1/office/engines/* surface are supported.

Base URL

Legacy surface:
Converged v1 surface:
For local development:

Authentication

Office engine routes inherit the standard bearer-token auth middleware. The raw request body and x-office-filename header are forwarded verbatim to the engine.

Endpoints

Parse a document

Parses an uploaded Office document into JSON. The binary body is forwarded as-is.

Headers

Example request

Example response

Convert to Markdown

Converts an uploaded document to Markdown.

Example request

Example response

Convert URL to Markdown

Accepts a JSON { "url": "..." } body and returns Markdown extracted from the remote Office document.

Example request

XLSX session

Supported operations: open, range, formulas, session-recalc, save, close. The request body is forwarded verbatim to the engine.

Example request

Error codes