Convert an already uploaded file
start_conversionStarts a conversion of a file that is already in FileConvert (a 'file_id' from upload_file or from an earlier job) from 'source_format' to 'target_format' (named by extension). Returns the 'job_id' to poll with get_job_status. Conversions consume account credits.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"file_id": "<file_id>"
},
"name": "start_conversion"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_id | Yes | The file id returned by upload_file (or by a previous conversion's converted file). | |
| format_type | No | Optional category hint ('image', 'document', …) when an extension exists in several categories. | |
| source_format | No | Current format of the file by extension, e.g. 'docx'. Required unless source_format_id is given. | |
| target_format | No | Desired output format by extension, e.g. 'pdf'. Same category as the source. Required unless target_format_id is given. | |
| format_type_id | No | Advanced: numeric format-type id from list_formats. | |
| source_format_id | No | Advanced: numeric source format id from list_formats. | |
| target_format_id | No | Advanced: numeric target format id from list_formats. | |
| additional_arguments | No | Optional free-form conversion arguments passed through to the converter. |