---
title: "Upload a file"
method: POST
path: "/v1/files"
tags: ["Gateway"]
---

# Upload a file

`POST /v1/files`

## Request

- Base URL: `https://api.roar-ai.com`
- URL: `https://api.roar-ai.com/v1/files`
- Auth: HTTP bearer

OpenAI-compatible. `multipart/form-data`. Files are what a batch reads its requests from — upload with `purpose: batch`, then name the returned id in `POST /v1/batches`. Requires `inference`.

## Response `200`

The stored file

## Other responses

- `400`: Bad upload
- `401`: Missing or invalid key

---

[API](https://skmtc.dev/roar-ai/apis/roar-ai-api.md) · [All operations](https://skmtc.dev/roar-ai/apis/roar-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/roar-ai/apis/roar-ai-api/revisions/37e4d0d5a7fe?raw)