> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Conversion Tools

> Conversion Tools is an online service that offers a fast and easy way to convert documents between different formats, like XML, Excel, PDF, Word, Text, CSV, and others.

![Conversion Tools logo](https://mintcdn.com/composio-preview/NPf8agM6UrvZD-Iu/images/toolkits/conversion_tools.svg?fit=max\&auto=format\&n=NPf8agM6UrvZD-Iu\&q=85\&s=8621e170ac5dc7ea23690fad32c023dc)

* **Category:** documents
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 11
* **Triggers:** 0
* **Slug:** `CONVERSION_TOOLS`
* **Version:** 20261101\_00

## Tools

> [accordion] Convert Excel to HTML
>
> **Slug:** `CONVERSION_TOOLS_CONVERT_EXCEL_TO_HTML`
>
> Convert an Excel (.xlsx) file to HTML table format. Use when you need to transform spreadsheet data into an HTML representation. Provide either a file upload or a public URL to the Excel file. Returns a task\_id that can be used to check the conversion status and download the result once complete.
>
> #### Input Parameters
>
> **file** `object`
>
> Excel file to upload for conversion. Required if file\_url is not provided.
>
> **options** `object`
>
> Optional conversion settings. Example: \{'sheet': 'Sheet1'} to convert a specific sheet.
>
> **file\_url** `string`
>
> Public URL to the Excel file to convert (e.g., '[https://example.com/data.xlsx](https://example.com/data.xlsx)'). Required if file is not provided.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Convert Word to Text
>
> **Slug:** `CONVERSION_TOOLS_CONVERT_WORD_TO_TEXT`
>
> Create a Word-to-text conversion task from a document or public URL and poll for completion for approximately 60 seconds. Returns the task status; a download URL is included only if the successful status response supplies it.
>
> #### Input Parameters
>
> **file** `string`
>
> Binary content of the Word document (.doc/.docx) to convert. Mutually exclusive with 'file\_url'.
>
> **file\_url** `string`
>
> Publicly accessible URL of the Word document (.doc/.docx) to convert. Mutually exclusive with 'file'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Conversion Task
>
> **Slug:** `CONVERSION_TOOLS_CREATE_TASK`
>
> Create a conversion task for one of the supported types, including XML, JSON, Excel, PDF, CSV, images, audio/video and websites; sandbox mode permits quota-free testing. The task ID is returned when present in the nested response data.
>
> #### Input Parameters
>
> **url** `string`
>
> Public URL of the file or website to convert. Required for website conversions or when converting a file from the internet. Mutually exclusive with file\_id.
>
> **type** `string ("convert.xml_to_excel" | "convert.json_to_excel" | "convert.csv_to_excel" | "convert.excel_to_csv" | "convert.excel_to_xml" | "convert.excel_to_json" | "convert.xml_to_csv" | "convert.xml_to_json" | "convert.json_to_xml" | "convert.csv_to_xml" | "convert.html_table_to_csv" | "convert.pdf_to_text" | "convert.pdf_to_excel" | "convert.pdf_to_csv" | "convert.pdf_to_word" | "convert.pdf_to_jpg" | "convert.pdf_to_png" | "convert.word_to_pdf" | "convert.excel_to_pdf" | "convert.powerpoint_to_pdf" | "convert.word_to_text" | "convert.word_to_html" | "convert.powerpoint_to_text" | "convert.powerpoint_to_html" | "convert.markdown_to_pdf" | "convert.markdown_to_html" | "convert.markdown_to_epub" | "convert.website_to_pdf" | "convert.website_to_jpg" | "convert.website_to_png" | "convert.html_to_jpg" | "convert.html_to_png" | "convert.jpg_to_pdf" | "convert.png_to_pdf" | "convert.pdf_to_svg" | "convert.png_to_svg" | "convert.png_to_webp" | "convert.jpg_to_avif" | "convert.png_to_avif" | "convert.avif_to_png" | "convert.avif_to_jpg" | "convert.mp4_to_mp3" | "convert.wav_to_mp3" | "convert.flac_to_mp3" | "convert.mp3_to_wav" | "convert.mov_to_mp4" | "convert.mkv_to_mp4" | "convert.avi_to_mp4" | "convert.ocr_pdf_to_text" | "convert.ocr_jpg_to_text" | "convert.ocr_png_to_text" | "convert.excel_to_ods" | "convert.ods_to_excel" | "convert.ods_to_csv" | "convert.ods_to_pdf" | "convert.fix_xml_escaping" | "convert.excel_xml_to_excel_xlsx")` *required*
>
> Conversion type identifier in format convert.\{source}*to*\{target}. Choose from 59 supported conversion types including XML, JSON, Excel, PDF, CSV, images, audio/video, and more.
>
> **file\_id** `string`
>
> File ID returned by POST /files endpoint. Required when converting an uploaded file. Mutually exclusive with url.
>
> **sandbox** `boolean`
>
> Enable sandbox mode for unlimited testing without counting against quota. Returns mock data in 2-5 seconds. Useful for testing workflows before production use.
>
> **callbackUrl** `string`
>
> Webhook URL to receive task completion notification. The API will POST to this URL when conversion finishes.
>
> **additional\_options** `object`
>
> Additional conversion-specific options. Examples: filename (output name), pages (page ranges like '1-5,7'), delimiter (CSV separator), quality (image quality), etc. Varies by conversion type.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Download Converted File
>
> **Slug:** `CONVERSION_TOOLS_DOWNLOAD_FILE`
>
> Download a converted file from the Conversion Tools API using its file ID. Use this action after a conversion task completes successfully. The file\_id is obtained from the task status response when status is 'SUCCESS'. Converted files are automatically deleted after 24 hours. Workflow: 1. Run a conversion task (e.g., convert\_website\_to\_pdf) 2. Check task status until status is 'SUCCESS' 3. Use the file\_id from the task response to download the result
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> Unique identifier (32-character hex string) of the converted file to download. Obtain this ID from a completed conversion task's response.
>
> **filename** `string`
>
> Optional filename for the downloaded file. If not provided, the filename will be extracted from the API response headers or derived from the file\_id.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Auth Info
>
> **Slug:** `CONVERSION_TOOLS_GET_AUTH_INFO`
>
> Tool to get information about the authenticated user including email address. Use when you need to verify API credentials or retrieve the user's email.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Conversion Config
>
> **Slug:** `CONVERSION_TOOLS_GET_CONFIG`
>
> Tool to get available conversion types and their configuration. Returns the list of all supported conversions with their options. Use this to discover what conversions are available and what parameters they accept.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get File Info
>
> **Slug:** `CONVERSION_TOOLS_GET_FILE_INFO`
>
> Tool to get metadata about a file including size, name, and preview (for text files). Use when you need to retrieve information about a previously uploaded file. This does NOT count against your quota.
>
> #### Input Parameters
>
> **file\_id** `string` *required*
>
> Unique identifier (32-character hex string) of the file to retrieve information about.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Task Status
>
> **Slug:** `CONVERSION_TOOLS_GET_TASK_STATUS`
>
> Tool to get the status of a conversion task. Poll this endpoint until status is SUCCESS or ERROR. On SUCCESS, the response includes file\_id which can be used to download the result file.
>
> #### Input Parameters
>
> **task\_id** `string` *required*
>
> The task ID returned from task creation. A 32-character hexadecimal string uniquely identifying the conversion task.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Conversion Tasks
>
> **Slug:** `CONVERSION_TOOLS_LIST_TASKS`
>
> Get all tasks for the authenticated user (up to 50 most recent tasks). Use this action to retrieve conversion task history, check task statuses, or find completed tasks for downloading results. This does NOT count against your API quota. Filter by status to retrieve only tasks in a specific state (PENDING, RUNNING, SUCCESS, or ERROR).
>
> #### Input Parameters
>
> **status** `string ("PENDING" | "RUNNING" | "SUCCESS" | "ERROR")`
>
> Task status enumeration for filtering tasks.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Task Retention
>
> **Slug:** `CONVERSION_TOOLS_UPDATE_TASK_RETENTION`
>
> Tool to update the retention mode for a task. Use when you need to change how long task files are kept before automatic deletion. Standard mode (standard\_24h) retains files for 24 hours. TTL mode (ttl\_15m) is for paid users only and deletes files after 15 minutes.
>
> #### Input Parameters
>
> **task\_id** `string` *required*
>
> Unique identifier (32-character hex string) of the task to update. Obtain this ID from a conversion task response.
>
> **retentionMode** `string ("standard_24h" | "ttl_15m")` *required*
>
> Retention mode for task files. 'standard\_24h' (default) retains files for 24 hours. 'ttl\_15m' (paid users only) retains files for 15 minutes and automatically deletes them afterward.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Upload File
>
> **Slug:** `CONVERSION_TOOLS_UPLOAD_FILE`
>
> Upload a file to the ConversionTools API for subsequent conversion operations. This action uploads a file and returns a file\_id that can be used with other conversion actions such as convert\_word\_to\_text, convert\_excel\_to\_csv, convert\_oxps\_to\_pdf, etc. Supported formats include: documents (DOC, DOCX, PDF, TXT, RTF), spreadsheets (XLS, XLSX, CSV), images (PNG, JPG, GIF, BMP), and various other file types.
>
> #### Input Parameters
>
> **file** `string` *required*
>
> Binary content of the file to upload. Can be provided as base64-encoded string or raw bytes.
>
> **filename** `string` *required*
>
> Name of the file including extension (e.g., 'document.docx', 'spreadsheet.xlsx', 'image.png'). The extension determines how the file will be processed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
