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

# Create File

`POST /api/v1alpha1/assistant/{assistant_kind}/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

---

[API](https://skmtc.net/trademeai/apis/trade-me-ai-platform.md) · [All operations](https://skmtc.net/trademeai/apis/trade-me-ai-platform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trademeai/trade-me-ai-platform/revisions/02634860dec7/schema)