---
title: "Convert"
method: POST
path: "/v1/convert"
tags: ["Documents"]
---

# Convert

`POST /v1/convert`

Convert documents between formats.

## Supported Conversions
- **DOCX → PDF**: Convert Word documents to PDF
- **Markdown → DOCX**: Convert Markdown to Word documents
- **HTML → DOCX**: Convert HTML to Word documents

## Examples
```bash
# Convert DOCX to PDF
curl -X POST "https://api.superdoc.dev/v1/convert?from=docx&to=pdf" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@document.docx" \
  -o output.pdf

# Convert Markdown to DOCX
curl -X POST "https://api.superdoc.dev/v1/convert?from=md&to=docx" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@document.md" \
  -o output.docx

# Convert HTML to DOCX
curl -X POST "https://api.superdoc.dev/v1/convert?from=html&to=docx" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@document.html" \
  -o output.docx
```

## Limitations
- File size: 25MB maximum
- Concurrent requests: 10 per API key

## Query parameters

- `from` 'docx' | 'md' | 'html', required
- `to` 'pdf' | 'docx'

## Response `200`

Converted file

## Other responses

- `400` — Standard error format used across all API endpoints
- `401` — Standard error format used across all API endpoints
- `413` — Standard error format used across all API endpoints
- `429` — Standard error format used across all API endpoints

---

[API](https://skmtc.dev/superdoc-dev/apis/superdoc-api.md) · [All operations](https://skmtc.dev/superdoc-dev/apis/superdoc-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/superdoc-dev/superdoc-api/revisions/869ccb471697/schema)