Skip to content

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
string
Required
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"
}

Playground

Authorization
Variables
Key
Value
Body

Samples

Powered by VitePress OpenAPI

Built solo on dedicated metal.