01
Auto-index new files
- Watch for new uploads
- Chunk, embed, and index
- Make queryable via your knowledge persona
Conversion Tools
11 tools available
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.
Connect Conversion Tools to Definable to auto-index uploads, answer questions over a doc set, extract structured fields from contracts. Personas call Conversion Tools's 11 tools directly from chat or scheduled flows. Connect this integration to a knowledge persona — the agent will ground answers in your documents with citations.
Common workflows with Conversion Tools
02
Q&A against a folder
- Pin a folder as a brain
- Ask the persona questions
- Returns answers with citations
03
Document-trigger flows
- New contract uploaded
- Persona extracts key terms
- Routes to the right approver
Conversion Tools actions 11
Every Conversion Tools action below is a callable tool any Definable persona can invoke.
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.
Convert Word to Text
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.
Create Conversion Task
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.
Download Converted 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
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.
Get Conversion 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.
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.
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.
List Conversion 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).
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.
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.
Algodocs
AlgoDocs is an AI-powered platform that automates data extraction from business documents, offering fast, secure, and accurate processing without the need for templates or training.
API2PDF
Api2Pdf is a REST API that enables developers to generate PDFs from HTML, URLs, and various document formats using engines like wkhtmltopdf, Headless Chrome, and LibreOffice.
Boldsign
BoldSign delivers eSignature solutions, letting organizations create, send, and manage legally binding documents through streamlined digital signing workflows
Boloforms
BoloForms is an eSignature platform designed for small businesses, offering unlimited signatures, templates, forms, and team members at a fixed price.
Box
Box is a cloud content management platform for secure file storage, sharing, collaboration, and governance.
Carbone
Carbone is a fast and simple report generator that converts JSON data into various document formats such as PDF, DOCX, XLSX, ODT, and more, using templates.
Frequently asked questions
What can I automate with Conversion Tools on Definable?
Anything Conversion Tools exposes through its API. Common documents workflows on Definable include auto-index uploads, answer questions over a doc set, extract structured fields from contracts. Personas can call any of the 11 Conversion Tools tools directly, then chain the result into another integration without you writing code.
How does Conversion Tools authentication work?
Conversion Tools uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.
Is the Conversion Tools integration included in my Definable plan?
Yes — every Definable plan, including Starter, includes access to all 11 Conversion Tools tools. You only need a separate Conversion Tools subscription if Conversion Tools itself charges per seat or per API call.
Is using Conversion Tools through Definable secure?
Every call from a persona to Conversion Tools is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.
How do I get started with Conversion Tools on Definable?
Sign up for Definable, open the integrations page, find Conversion Tools, and connect via OAuth or API key. You can immediately attach Conversion Tools to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.
What Conversion Tools actions does Definable expose?
Definable exposes all 11 Conversion Tools actions as callable tools — including `Convert Excel to HTML`, `Convert Word to Text`, `Create Conversion Task`, plus 8 more. Each tool gets a typed parameter schema so personas know exactly how to call it.
Ready to automate with Conversion Tools?
Wire it up in minutes. No coding required.