Skip to content

Create a bulk conversion

POST
/conversions/bulk

Submits multiple files for conversion in a single request. Each
item burns one conversion-rate token. Pro users can submit up to 20
items; free-tier users cannot use bulk.

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
{
  
"items": [
  
  
{
  
  
  
"input_file_id": "string",
  
  
  
"target_format": "string",
  
  
  
"preset": {
  
  
  
  
"id": "string"
  
  
  
},
  
  
  
"preserve_metadata": true
  
  
}
  
]
}

Responses

Bulk conversion enqueued

application/json
JSON
{
  
"bulk_id": "string",
  
"total": 0,
  
"items": [
  
  
{
  
  
  
"conversion_id": "string",
  
  
  
"input_file_id": "string",
  
  
  
"target_format": "string"
  
  
}
  
]
}

Playground

Authorization
Body

Samples

Powered by VitePress OpenAPI

Built solo on dedicated metal.