DocuShell Docs

Developer Hub

DocuShell API Docs

DocuShell gives developers, freelancers, and businesses one async API surface for parsing PDFs, rendering documents, capturing webpages, compressing files, and converting PDFs to Word.

Overview4 min
View as Markdown

Base URL

https://api.docushell.com/api

Use this as the API client base, then call /v1/... routes from your server or automation.

Auth

Bearer + Idempotency-Key

Bearer authentication is required. Idempotency is optional but recommended for every submit call.

Job flow

queued -> processing -> done

Submit work, poll /v1/jobs/:jobId, then stream artifacts or files from the shared download route.

Section

Who This Is For

Developers use DocuShell when they want stable HTTP endpoints and clean copy-paste samples instead of building PDF processing pipelines from scratch.

Freelancers use the same queued job model to automate deliverables like parsed research packets, branded Markdown exports, or client-ready PDF conversions.

Businesses get one public gateway and one auth model across the PDF stack, even though the work happens in dedicated services behind the scenes.

Section

Start Here

Section

Endpoint Inventory

This is the canonical public API surface documented in this hub.

Section

First Request

Use the Markdown lane for a fast smoke test of auth, idempotency, status polling, and downloads.

First request

bash

curl -X POST "https://api.docushell.com/api/v1/markdown-to-pdf" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: quickstart-001" \
  -d '{
    "markdown": "# DocuShell\n\nRendered through the public API.",
    "file_name": "quickstart.md",
    "page_size": "A4"
  }'