# BrewMyPDF API

**Canonical:** https://apis.io/apis/brewmypdf-com/brewmypdf-com-api/  
**Provider:** BrewMyPDF — https://apis.io/providers/brewmypdf-com/  
**Documentation:** https://brewmypdf.com/docs/api

BrewMyPDF API is published by [BrewMyPDF](https://apis.io/providers/brewmypdf-com/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

BrewMyPDF API as documented publicly: 28 operations. Contract generated from the documentation by API Evangelist (2026-11-03); not the provider's own document.

## Operations (28)

| Method | Path | Summary |
|---|---|---|
| POST | `/mcp` | Using BrewMyPDF from an AI agent (MCP) |
| GET | `/v1/account` | Test the key with GET /v1/account — it is cheap and has no side effects. |
| POST | `/v1/assets` | Upload a background image with POST /v1/assets. |
| DELETE | `/v1/assets/{id}` | Delete with DELETE /v1/assets/{id}. |
| POST | `/v1/batch` | Many at once POST /v1/batch takes an items array — up to 50 — and queues them together. |
| POST | `/v1/create` | Render now POST /v1/create renders and answers in the same request. |
| POST | `/v1/create-async` | POST /v1/create-async |
| POST | `/v1/embed/sessions` | POST /v1/embed/sessions creates an embed session for the editor. |
| POST | `/v1/files` | Upload a PDF with POST /v1/files — put the PDF straight in the body with content-type: application/pdf. |
| GET | `/v1/files/{id}` | GET /v1/files/{id} tells you what the file is: how many pages, the size and rotation of each one, whether it is encrypted, whether it carries an XFA form, an... |
| POST | `/v1/intake/runs` | POST /v1/intake/runs takes documents folded into data objects for spreadsheet intake. |
| GET | `/v1/intake/runs/{id}` | GET /v1/intake/runs/{id} returns status and URLs for a finished intake run. |
| POST | `/v1/intake/runs/{id}/zip` | POST /v1/intake/runs/{id}/zip builds that ZIP for a finished run — streamed to storage, up to 500 MB in total. |
| POST | `/v1/jobs/01M0` | POST /v1/jobs/01M0 |
| GET | `/v1/jobs/{id}` | GET /v1/jobs/{id} reports the state and, once done, the same signed URL. |
| POST | `/v1/jobs/{id}/retry` | A failed job can be run again with POST /v1/jobs/{id}/retry. |
| POST | `/v1/pdf/fields` | POST /v1/pdf/fields fills in form fields that already exist. |
| POST | `/v1/pdf/merge` | POST /v1/pdf/merge joins files in the order you list them, up to 20. |
| POST | `/v1/pdf/stamp` | POST /v1/pdf/stamp writes text onto a file. |
| GET | `/v1/templates` | Fill a template dropdown with GET /v1/templates. |
| POST | `/v1/templates` | POST /v1/templates creates one from { name, doc } and returns template_id and version_id. |
| DELETE | `/v1/templates/{id}` | DELETE /v1/templates/{id} is a soft delete — past renders keep their history. |
| GET | `/v1/templates/{id}` | GET /v1/templates/{id} returns the template with its current doc and schema_version. |
| PUT | `/v1/templates/{id}` | PUT /v1/templates/{id} updates it: pass doc to write a new version, name to rename, or both. |
| GET | `/v1/templates/{id}/form` | GET /v1/templates/{id}/form?format=xlsx (or csv) returns the data form for spreadsheet intake. |
| GET | `/v1/templates/{id}/schema` | GET /v1/templates/{id}/schema returns the template schema (paths and JSON Schema). |
| GET | `/v1/templates/{id}/versions` | GET /v1/templates/{id}/versions lists versions (without doc bodies — newest first, current marked). |
| POST | `/v1/templates/{id}/versions/{vid}/restore` | POST /v1/templates/{id}/versions/{vid}/restore makes an older version current again. |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/brewmypdf-com/openapi/_ae-authored/brewmypdf-com-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/brewmypdf-com/json-schema/brewmypdf-com-post-mcp-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/brewmypdf-com/json-schema/brewmypdf-com-post-mcp-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/brewmypdf-com/json-schema/brewmypdf-com-post-v1-intake-runs-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/brewmypdf-com/json-schema/brewmypdf-com-post-v1-pdf-stamp-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/brewmypdf-com/json-schema/brewmypdf-com-post-v1-pdf-fields-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/brewmypdf-com/json-schema/brewmypdf-com-post-v1-embed-sessions-request-schema.json
- **APIsJSON** — https://artifacts.apis.io/brewmypdf-com/apis.yml

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/brewmypdf-com/brewmypdf-com-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/brewmypdf-com/.