Skip to content

Get a presigned upload URL​

POST
/files/presign-upload

Returns a one-time presigned URL for uploading an input file to
object storage. After uploading, call POST /files/{id}/finalize
to register the file with FileForge and trigger virus scanning.

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)

Request Body​

application/json
JSON
{
  
"filename": "string",
  
"size": 0,
  
"mime": "string"
}

Responses​

Presigned upload details

application/json
JSON
{
  
"file_id": "string",
  
"bucket": "string",
  
"storage_key": "string",
  
"upload_url": "string",
  
"expires_in": 0
}

Playground​

Authorization
Body

Samples​

Powered by VitePress OpenAPI

Built solo on dedicated metal.