API reference
Convert
Start a conversion job for a previously uploaded file.
Create a conversion
POST
https://api.markitdown.ai/convertConvert an uploaded file to MarkdownStarts an asynchronous job for an uploaded fileId. Returns the job; poll GET /jobs/{id} or subscribe to a webhook, then read GET /jobs/{id}/result.
Body
fileIdrequired | uuid | The uploaded file to convert. |
estimatedCreditsrequired | integer | Credits you authorize for the job (from /files/inspect). |
quality | "fast" | "standard" | "max" | Parsing route; higher quality costs more per page. |
ocr | boolean | Force OCR for image-only / scanned pages. |
tableMode | "fast" | "accurate" | Table extraction fidelity. |
describeFigures | boolean | Opt in to the VLM figure-description pass (paid plans, PDF/Office). |
Responses
200 | Job | Conversion job created. |
400 | Error | Invalid body. |
402 | Error | Insufficient credits. |
403 | Error | Insufficient scope or plan upload limit. |
429 | Error | Rate limited. |