> ## Documentation Index
> Fetch the complete documentation index at: https://docs.handauncle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# File Upload API

> Upload images or PDFs, list prior uploads, and manage attachments.

The file service is mounted at `/api/v1/files` and fronts Google Cloud Storage
for binary uploads. All routes require an Auth0 Bearer token.

### Supported media

* Images: JPEG, PNG, GIF, WebP (≤10 MB)
* PDFs: application/pdf (≤20 MB)

### Surface area

| Action  | Endpoint                                   | Description                                                                    |
| ------- | ------------------------------------------ | ------------------------------------------------------------------------------ |
| Upload  | [`POST /files/upload`](./files/upload)     | Accepts `multipart/form-data` and stores the file in GCS plus MongoDB metadata |
| List    | [`GET /files`](./files/list)               | Returns the caller’s uploads with optional conversation filtering              |
| Inspect | [`GET /files/{fileId}`](./files/get)       | Loads metadata for a single upload                                             |
| Delete  | [`DELETE /files/{fileId}`](./files/delete) | Removes both the GCS object and the Mongo record after verifying ownership     |

See the endpoint pages for request bodies, parameter constraints, and example
responses pulled directly from the OpenAPI schema.