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.