Finalize an uploaded file
POST
/files/{id}/finalize
Confirms that an uploaded file exists in storage, runs a virus scan,
verifies the declared MIME matches the actual content, and registers
the file in the database. The file must have been uploaded to the
presigned URL returned by POST /files/presign-upload.
Authorizations
ApiKeyAuth
Pass your ff_live_… API key as a Bearer token in the
Authorization header, or as the value of the X-API-Key header.
Type
HTTP (bearer)
Parameters
Path Parameters
id*
The file_id returned by presign-upload
Type
Requiredstring
Format
"uuid"Request Body
application/json
JSON "storage_key": "string", "original_name": "string", "declared_mime": "string"
{
}
Responses
File registered and scanned successfully
application/json
JSON "id": "string", "original_name": "string", "mime_type": "string", "size_bytes": 0, "expires_at": "string", "created_at": "string"
{
}
