---
title: "Create Upload Url"
method: POST
path: "/api/files/upload-url"
tags: ["files", "files"]
---

# Create Upload Url

`POST /api/files/upload-url`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/files/upload-url`
- Auth: none declared

Start a direct-to-storage upload. PUT the bytes, then POST /complete.

## Request body

- CreateUploadUrlRequest
  - `filename` string, required
  - `mime_type` string, nullable
  - `size_bytes` integer, required: Exact byte length of the file
  - `sha256` string, nullable: Hex sha256; enables dedup + verification
  - `title` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/77bef09a9209?raw)