---
title: "Upload a file"
method: POST
path: "/lucca-files/api/uploads"
tags: ["Files"]
---

# Upload a file

`POST /lucca-files/api/uploads`

Upload a file.

## Headers

- `Accept` 'application/json', required
- `Content-Type` 'multipart/form-data', required

## Response `201`

Created

- File — A file resource.
  - `id` string, uuid
  - `name` string — File name.
  - `createdAt` string, date-time — UTC timestamp of the moment this file was uploaded.
  - `deletedAt` string, nullable — UTC timestamp of the moment this file was deleted. When null, file is not deleted.
  - `contentLength` integer — File size in bytes.
  - `contentType` 'eml message/rfc822' | 'image/heic' | 'image/heif' | 'image/jpe' | 'image/jpg' | 'image/pjpeg' | 'image/gif' | 'image/bmp' | 'image/tif' | 'image/tiff' | 'image/x-dcraw' | 'image/x-jb2' | 'image/x-jbig2' | 'image/x-jpf' | 'image/x-ms-bmp' | 'image/x-panasonic-raw' | 'image/x-pcx' | 'image/x-icon' | 'image/x-png' | 'image/vnd.microsoft.icon' | 'image/webp' | 'image/x-portable-anymap' | 'text/plain' | 'text/csv' | 'text/rtf' | 'text/calendar' | 'text/comma-separated-values' | 'text/markdown' | 'application/pdf' | 'application/msword' | 'application/xls' | 'application/x-csv' | 'application/ms-excel' | 'application/vnd.ms-office' | 'application/vnd.ms-word' | 'application/vnd.ms-outlook' | 'application/vnd.ms-powerpoint' | 'application/vnd.ms-excel' | 'application/vnd.oasis.opendocument.text' | 'application/vnd.oasis.opendocument.spreadsheet' | 'application/vnd.oasis.opendocument.presentation' | 'application/vnd.oasis.opendocument.graphics' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' | 'application/vnd.openxmlformats-officedocument.presentationml.presentation' | 'application/vnd.openxmlformats-officedocument.presentationml.slideshow' | 'application/vnd.openxmlformats-officedocument.presentationml.template' | 'application/x-7z-compressed' | 'application/rar' | 'application/x-rar' | 'application/zip' | 'application/csv' | 'application/rtf' | 'application/text' | 'application/txt' | 'application/x-pdf'
  - `extension` string — Inferred from content-type (e.g.: '.pdf', '.doc', '.txt', etc...).
  - `totalPages` integer — Number of pages of a document file.

---

[API](https://skmtc.net/luccasoftware/apis/lucca-expenses.md) · [All operations](https://skmtc.net/luccasoftware/apis/lucca-expenses/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/luccasoftware/lucca-expenses/revisions/110f9897756c/schema)