---
title: "Create File"
method: POST
path: "/v2/aether/files"
tags: ["aether"]
---

# Create File

`POST /v2/aether/files`

## Request

- Base URL: `https://api.stuut.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stuut.ai/v2/aether/files`
- Auth: HTTP bearer

Create a file record and return a presigned upload URL.

## Request body

- CreateFileBody
  - `name` string, required
  - `mime_type` string

## Response `201`

Successful Response

- StuutApiServiceV2RoutersAetherSchemasFileFile
  - `id` string, uuid, required
  - `name` string, required
  - `mime_type` string, required
  - `bucket` string, required
  - `object_key` string, required
  - `upload_url` string, nullable
  - `upload_headers` object
  - `size` integer, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/stuut/apis/stuut-api.md) - [All operations](https://skmtc.dev/stuut/apis/stuut-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stuut/apis/stuut-api/revisions/3b5ab941f918?raw)