Version: 1.0.0

Propper Gen API

Document Generation API for the Propper Platform.

Base URL

• Production: https://api.propper.ai/v1/docgen

Authentication

OAuth 2.0 Bearer token:

Authorization: Bearer <access_token>

OAuth Scopes

Scope	Description
docgen:read	Read templates, documents, batches, approvals
docgen:write	Create/update templates, generate documents, create batches
docgen:admin	Archive/promote templates, cancel/retry batches, review approvals
docgen:preview	Render a template for review without generating a document. Standalone: not implied by docgen:read/write/admin

Granular Scopes

Scope	Description
docgen:templates:read	Read templates
docgen:templates:write	Create/update templates
docgen:documents:read	Read documents
docgen:documents:write	Generate documents
docgen:batches:read	Read batch jobs
docgen:batches:write	Create batch jobs
docgen:approvals:read	Read approvals
docgen:approvals:write	Review approvals

Key Endpoints

• GET /v1/docgen/templates - List templates
• POST /v1/docgen/templates - Create template
• POST /v1/docgen/templates/{id}/preview - Preview a template without generating a document
• POST /v1/docgen/documents - Generate document
• POST /v1/docgen/batches - Create batch job
• GET /v1/docgen/approvals/pending - List pending approvals

Rate Limits

Category	Limit
Default	300 req/min
Document Generation	60 req/min
Template Preview	120 req/min
Batch Creation	20 req/min
Downloads	120 req/min

---

Request correlation

Every response (success and error) includes an x-request-id header (a UUID) and a traceparent header (W3C Trace Context). Error bodies also carry the same id as requestId. Quote x-request-id when contacting support to pinpoint the exact request, and use it to correlate the API with your own logs. Send your own traceparent to tie a multi-call workflow under one trace.

Authentication

HTTP: Bearer Auth

OAuth 2.0 access token

Security Scheme Type:	http
HTTP Authorization Scheme:	bearer
Bearer format:	JWT