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

# Upload Excel Template

`POST /api/excel/templates/upload`

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

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/qomplement/apis/fastapi.md) · [All operations](https://skmtc.net/qomplement/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qomplement/fastapi/revisions/718de1c0d866/schema)