Skip to main content

Update file metadata and status (ASK-113)

PATCH 
/files/:file_id

Updates file metadata (rename) and/or transitions the upload status. Called by the Next.js server after the presigned-URL upload completes (or fails) to move the record from pending to complete or failed. Also supports standalone renaming of any non-deleted file the caller owns.

Both fields are optional but at least one must be provided.

Status transitions are restricted: only pending -> complete and pending -> failed are allowed. All other combinations return 400 INVALID_TRANSITION.

Request​

Responses​

Updated file