canonical: https://jentic.com/apis/conv2pdf.com/conv2pdf # conv2pdf API The conv2pdf API converts and manipulates PDF files through a single convert operation that exposes a set of named tools, each selected by the tool path parameter. It is hosted in France and deletes input and output files about an hour after a job runs, with no result caching. A caller lists the available tools, submits a file to a chosen tool, polls the job for status and metadata, then downloads the output or deletes the job. Each API key also carries a quota that the quota operation reports. ## For AI agents Convert and manipulate PDF files by submitting a file to a named conversion tool, then poll the job and download the result. Lists available tools and reports key quota. ## Scope Does not handle document storage, e-signatures, or data extraction from PDFs. Use for PDF conversion and manipulation only. ## Capabilities - List the available conversion and manipulation tools - Submit a file to a named tool to convert or manipulate a PDF - Poll a job for its status and metadata - Download the converted output file for a finished job - Delete a job and its stored files on demand - Report the current quota for an API key ## Use cases ### Agent document conversion An AI agent connected through Jentic lists the available tools, submits a source file to the chosen tool with the convert operation, polls the job until it finishes, and downloads the PDF. Because conv2pdf deletes input and output files about an hour after the job, the agent downloads the result promptly rather than relying on long-term storage. Example prompt: Submit a DOCX file to the conversion tool, poll the job until it reports done, and download the resulting PDF ### Batch file manipulation pipeline A back-office pipeline routes incoming files through conv2pdf tools to standardise them as PDFs before archiving. The single convert endpoint accepts the tool name in the path, so the pipeline picks the right tool per file and tracks each job independently through its status and download steps. Example prompt: For each file in a batch, call the matching conversion tool and download the output, then delete each completed job ### Quota-aware conversion Before launching a conversion run an agent reads the quota for its key so it does not start more jobs than the plan allows. conv2pdf reports the key quota on demand, letting the agent decide whether to proceed or wait. Example prompt: Read the key quota and only submit a conversion job when remaining quota is sufficient ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/tools` | List the available conversion tools | | POST | `/convert/{tool}` | Convert or manipulate a file with a named tool | | GET | `/job/{jobId}` | Get job status and metadata | | GET | `/download/{jobId}` | Download the converted output file | | DELETE | `/job/{jobId}` | Delete a job and its files | | GET | `/quota` | Report the quota for the API key | ## Key resources - **Tools** — List the available PDF conversion and manipulation tools - **Convert** — Submit a file to a named tool to convert or manipulate a PDF - **Jobs** — Read job status and metadata, download output, or delete a job - **Quota** — Report the current quota state for an API key ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 65 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 74 / 100 - Developer Experience & Jentic Compatibility: 71 / 100 - AI-Readiness & Agent Experience: 46 / 100 - Agent Usability: 94 / 100 - Security: 60 / 100 - AI Discoverability: 79 / 100 - **View full report:** https://jentic.com/apis/conv2pdf.com/conv2pdf/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the conv2pdf API by hand means issuing a cpdf_live_ bearer key, learning the single convert endpoint with its tool path parameter, and managing the submit, poll, and download job lifecycle. Through Jentic you install once, import conv2pdf from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** conv2pdf puts the tool name in the URL path (`/convert/{tool}`), so a rule can limit your agent to specific conversions and the job-status and download operations. You choose the operations it may call, so job deletion is not included unless you add it. - **Credential handling:** Your conv2pdf key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'convert a file to PDF', and Jentic returns the matching conv2pdf operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **CloudConvert** — CloudConvert converts between a wide range of document, image, and media formats, not only PDF. - **ConvertAPI** — ConvertAPI offers file conversion and PDF operations with a large operation set. - **CraftMyPDF** — CraftMyPDF generates PDFs from templates, where conv2pdf converts existing files. ## FAQ ### What authentication does the conv2pdf API use? The conv2pdf API authenticates with a bearer API key in the Authorization header, in the cpdf_live_ format, per its OpenAPI spec. Through Jentic the key is stored once by your own self-hosted instance and injected when a call runs, so it never appears in the agent's prompt or logs. ### Which conversions can I run with the conv2pdf API? Call the tools operation to list the conversion and manipulation tools your key can use, then submit a file to a chosen tool through the convert operation, which takes the tool name in the URL path. Poll the job for status and download the output when it is done. ### Can I limit what my agent is allowed to do with the conv2pdf API? Yes. conv2pdf puts the tool name in the URL path, so write a rule that allows only the specific conversions and the job-status and download operations your agent needs, and it cannot delete jobs or run other tools, with every call logged. ### How long does conv2pdf keep my files? Per the spec, input and output files are deleted about an hour after a job runs and results are not cached, while a failed conversion's file is kept for 72 hours for diagnosis and then removed. Download a finished output promptly rather than relying on long-term storage. ### Is there a conv2pdf MCP server? You don't need an MCP server to give your agent the conv2pdf API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent calls the convert and job operations on demand without loading another server's tool definitions into its context. ### How do I convert a file to PDF with the conv2pdf API through Jentic? Search Jentic by intent such as 'convert a document to PDF', and Jentic returns the convert operation with its input schema so your agent submits the file and tool, then polls and downloads the result. To run it on your own infrastructure, install Jentic One from its GitHub repo.