Create a file metadata record (ASK-105)
POST/files
Creates a file metadata record in pending status. Called
by the Next.js server as the first step of the upload flow,
BEFORE the client uploads to S3 via a presigned URL the
Next.js server generates separately. The Go API never
touches S3 for uploads -- it only manages metadata records.
A subsequent PATCH /api/files/{id} transitions the record
from pending to complete or failed.
Request
Responses
- 201
- 400
- 401
- 500
File metadata record created in pending status
Bad request
Unauthorized
Internal server error