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

# 📤 Upload file

`POST /file`

## Request

- Base URL: `http://localhost`
- URL: `http://localhost/file`
- Auth: one of:
  - API key in header `sid` and API key in header `rts` and API key in header `sig`
  - API key in header `sid` and API key in query parameter `fileToken`
  - API key in cookie `fsid`

Загрузка файла (multipart или raw body + name).

Query: `fid`, опционально `name`; сессия - как у скачивания (подпись, `fileToken` или кука `fsid`).

## Query parameters

- `sid` string, uuid
- `fileToken` string
- `fid` string, uuid, required
- `mode` 'icon' | 'preview' | 'data'
- `name` string

## Headers

- `devID` string, uuid, required
- `tz` string, required
- `app` string, required
- `appVer` string, required

## Response `200`

IServerResponse with file meta

- object
  - `code` integer, required
  - `data` object, required: IFileStorageFile meta
  - `srvTS` integer, required: Server timestamp (ms)
  - `rkey` string, required: Request key

## Other responses

- `401`: Session invalid
- `404`: File slot not found

---

[API](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api.md) · [All operations](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api/revisions/a143b51ba29a?raw)