---
title: "Convert a file"
method: POST
path: "/api/v1/convert"
---

# Convert a file

`POST /api/v1/convert`

## Request

- Base URL: `https://filetypeconverters.com`
- URL: `https://filetypeconverters.com/api/v1/convert`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Accepts multipart file uploads or JSON URL inputs. Use async=1 to queue a job. URL requests may omit from when the fetched filename or content type can be detected.

## Query parameters

- `async` '1'

## Request body

- object
  - `url` string, uri, required
  - `from` string: Optional when the URL can be detected.
  - `to` string, required
  - `vision` boolean
  - `options` object

## Response `200`

Converted file stream

## Other responses

- `202`: Queued conversion job
- `400`: Error response
- `401`: Error response
- `402`: Error response
- `403`: Error response
- `413`: Error response
- `415`: Error response
- `429`: Rate limited
- `500`: Error response
- `502`: Error response
- `504`: Error response

---

[API](https://skmtc.dev/filetypeconverters/apis/filetype-converters-api.md) · [All operations](https://skmtc.dev/filetypeconverters/apis/filetype-converters-api/llms.txt) · [OpenAPI document](https://skmtc.dev/filetypeconverters/apis/filetype-converters-api/revisions/b99ff5cdb9aa?raw)