Skip to content

Create a conversion

POST
/conversions

Submits a file for conversion. The input file must have been
finalized first. The target format and preset must be valid for the
input's source MIME type (see GET /formats). The conversion is
enqueued and processed asynchronously — poll GET /conversions/{id}
until status becomes completed or failed.

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

Responses

Conversion enqueued

application/json
JSON
{
  
"id": "string",
  
"status": "string",
  
"worker_type": "string",
  
"target_format": "string",
  
"preset": {
  
  
"id": "string",
  
  
"params": {
  
  
  
"additionalProperties": "string"
  
  
}
  
}
}

Playground

Authorization
Body

Samples

Powered by VitePress OpenAPI

Built solo on dedicated metal.