/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 | Accepts multipart/form-data and stores the file in GCS plus MongoDB metadata |
| List | GET /files | Returns the caller’s uploads with optional conversation filtering |
| Inspect | GET /files/{fileId} | Loads metadata for a single upload |
| Delete | DELETE /files/{fileId} | Removes both the GCS object and the Mongo record after verifying ownership |