Convert Visio
Convert → Convert Visio
The Convert Visio API converts Visio files to PDF, JPG, PNG, or TIFF. You send the Visio as Base64 (docContent), docName, OutputFormat (PDF/JPG/PNG/TIFF), IsPdfCompliant, PageIndex, PageCount, IncludeHiddenPages, SaveForegroundPage, SaveToolBar, AutoFit, and IsAsync. The API returns the converted file (or 202 + Location for async). Use the tester below to try it; more details are in the sections that follow.
Try the Convert Visio API
:::note Quick reference
Endpoint: POST /api/v2/ConvertVisio · Required: api-key, docContent, docName, OutputFormat, IsPdfCompliant, PageIndex, PageCount, IncludeHiddenPages, SaveForegroundPage, SaveToolBar, AutoFit, IsAsync
:::
:::info Try it live Use the form below to send your API key and Visio file (Base64). Set output format, page range, and options; the response is the converted file (or polling URL when async). No code required—fill the fields and click Send request. :::
Overview, parameters, and use cases
- Overview
- Parameters
- Use cases
What is Convert Visio?
This endpoint converts Visio files (.vsdx, .vsd, .vsdm) to PDF, JPG, PNG, or TIFF. You provide the Visio (Base64), docName, OutputFormat (PDF, JPG, PNG, TIFF), IsPdfCompliant, PageIndex (0-based start), PageCount, IncludeHiddenPages, SaveForegroundPage, SaveToolBar, AutoFit, and IsAsync. The API returns the converted file or a Location URL for async.
Key features
- Output formats – PDF, JPG, PNG, TIFF.
- Page selection – PageIndex (start), PageCount (number of pages).
- Options – Include hidden pages, foreground, toolbar, auto-fit.
- Async – IsAsync returns 202 with Location URL for polling.
:::tip Best for Use when you need PDF or images from Visio diagrams. For general document conversion use Convert to PDF. :::
API parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| api-key | string | Yes | Your PDF4me API key, Base64 encoded. Get it from the dashboard. |
| docContent | base64 | Yes | Visio file content (Base64). .vsdx, .vsd, .vsdm. |
| docName | string | Yes | Output file name (e.g. output). |
| OutputFormat | string | Yes | PDF, JPG, PNG, or TIFF. |
| IsPdfCompliant | boolean | Yes | Make PDF compliant with standards. |
| PageIndex | integer | Yes | Start page (0-indexed). |
| PageCount | integer | Yes | Number of pages to convert (1–100). |
| IncludeHiddenPages, SaveForegroundPage, SaveToolBar, AutoFit | boolean | Yes | Page and layout options. |
| IsAsync | boolean | Yes | Enable asynchronous processing. |
When to use Convert Visio
- Diagrams – Convert Visio diagrams to PDF or images for sharing.
- Archival – Save Visio files as PDF for long-term storage.
- Pipelines – Convert Visio to PDF or images for reports or web.
:::info Need the full API? For request/response schemas and code samples, see Convert Visio in the PDF4me API docs. :::
Prerequisites
Before using this endpoint, make sure you have:
- A valid PDF4me API key (Get your API Key)
- A Visio file (.vsdx, .vsd, .vsdm) in Base64 format
Response Format
The API returns the converted file in the requested format:
- Status 200: Visio conversion completed immediately - binary file content in response body
- Status 202: Request accepted and processing asynchronously - use the Location header URL to poll for results
For asynchronous requests, poll the Location URL until status 200 is returned with the converted file.