---
title: "Upload Excel Template"
method: POST
path: "/api/excel/templates/upload"
tags: ["Excel Processing"]
---

# Upload Excel Template

`POST /api/excel/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/excel/templates/upload`
- Auth: HTTP bearer

Upload and save an Excel template for future use.
Extracts schema and stores file in S3.
Supports both authenticated users and guest mode.

Args:
    file: Excel file (.xlsx or .xls)
    description: Optional description of the template
    current_user: Authenticated user (optional for guest mode)

Returns:
    {
        "template_id": "uuid",
        "name": "filename.xlsx",
        "detected_fields": [...],
        "s3_key": "excel_templates/..."
    }

## Query parameters

- `description` string, nullable

## Request body `multipart/form-data`

- BodyUploadExcelTemplateApiExcelTemplatesUploadPost
  - `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)