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

# Upload a file

`POST /files`

## Request

- Base URL: `https://sdukstudio.com/api`
- URL: `https://sdukstudio.com/api/files`
- Auth: HTTP bearer

multipart/form-data with a `file` part. Returns the file metadata; put the returned id on the entity’s file/image column.

## Query parameters

- `entity` string
- `field` string

## Response `201`

File metadata

- FileMeta
  - `id` integer
  - `originalName` string
  - `mimeType` string
  - `sizeBytes` integer
  - `entitySlug` string, nullable
  - `fieldSlug` string, nullable
  - `ownerUserId` integer, nullable

## Other responses

- `400`: Validation error
- `403`: Forbidden
- `413`: File too large

---

[API](https://skmtc.dev/sdukstudio/apis/sduk-studio-info-site-api.md) · [All operations](https://skmtc.dev/sdukstudio/apis/sduk-studio-info-site-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sdukstudio/apis/sduk-studio-info-site-api/revisions/d7877b33dad3?raw)