---
title: "Upload Pdf Template"
method: POST
path: "/api/pdf/templates/upload"
tags: ["PDF Form Processing"]
---

# Upload Pdf Template

`POST /api/pdf/templates/upload`

## Request

- Base URL: `https://api.qomplement.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.qomplement.com/api/pdf/templates/upload`
- Auth: HTTP bearer

Upload and save a PDF form template for future use.
Extracts form fields and stores file in S3.

Args:
    file: PDF file
    description: Optional description
    current_user: Authenticated user (optional for guest mode)

Returns:
    {
        "template_id": "uuid",
        "name": "filename.pdf",
        "detected_fields": [...],
        "page_count": int,
        "s3_key": "pdf_templates/..."
    }

## Query parameters

- `description` string, nullable

## Request body `multipart/form-data`

- BodyUploadPdfTemplateApiPdfTemplatesUploadPost
  - `file` string, binary, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/qomplement/apis/qomplement-api.md) - [All operations](https://skmtc.dev/qomplement/apis/qomplement-api/llms.txt) - [OpenAPI document](https://skmtc.dev/qomplement/apis/qomplement-api/revisions/6fe617c112ef?raw)