---
title: "Create File"
method: POST
path: "/api/v1alpha1/assistant/trademe/files"
tags: ["v1alpha1"]
---

# Create File

`POST /api/v1alpha1/assistant/trademe/files`

Mint a signed PUT URL for a new upload. Write-only, like POST /conversations —
this mints a new id and surfaces no pre-existing state.

## Headers

- `authorization` string, nullable

## Request body

- CreateFileBody
  - `contentType` string, required

## Response `201`

Successful Response

- CreateFileResponse
  - `fileId` string, required
  - `ref` string, required
  - `putUrl` string, required
  - `expiresAt` string, date-time, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-17** `4a6ad0ee6b5e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/trademeai/apis/trade-me-ai-platform/changes/api/v1alpha1/assistant/trademe/files/post.md)

---

[API](https://skmtc.dev/trademeai/apis/trade-me-ai-platform.md) · [All operations](https://skmtc.dev/trademeai/apis/trade-me-ai-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/trademeai/apis/trade-me-ai-platform/revisions/9b0a47953d06?raw)