Conversion Tools

Tool to create a new conversion task. This is the main endpoint for performing conversions across 100+ conversion types including XML, JSON, Excel, PDF, CSV, images, audio/video, and more. Use when you need to convert any supported file format or website. Counts against quota unless sandbox mode is enabled.

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.

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.

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.

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.

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).

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.

Convert Word documents (.doc/.docx) to plain text (.txt). The action uploads the document, waits for conversion to complete (up to ~60 seconds), and returns the task status with a URL to download the converted text file. Use when you need to extract text content from Word documents for further processing.

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

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.