# File Convert Online — Public Agent API Mcp API

**Canonical:** https://apis.io/apis/file-convert-online/file-convert-online-public-agent-api-mcp-api/  
**Provider:** FileConvert — https://apis.io/providers/file-convert-online/  
**Base URL:** https://file-convert.online  
**Documentation:** https://file-convert.online/developers

File Convert Online — Public Agent API Mcp API is one of 2 APIs that [FileConvert](https://apis.io/providers/file-convert-online/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Programmatic interface for file conversion at file-convert.online. Covers the full agent workflow: discover formats, upload a source file, start a conversion, poll for completion, and download the result. All endpoints are fronted by the Traefik gateway; clients talk only to https://file-convert.onl

## Operations (14)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/conversion/v1/file_formats/types` | List all format-type categories (document, image, video, audio, …). |
| GET | `/api/conversion/v1/file_formats` | List all supported file formats. |
| GET | `/api/conversion/v1/file_formats/{type}` | List supported file formats filtered by format-type ID. |
| GET | `/api/conversion/v1/effects` | List all available post-processing effects. |
| GET | `/api/conversion/v1/status` | List canonical conversion status definitions. |
| POST | `/api/file/v1/file` | Upload a source file for conversion. |
| GET | `/api/file/v1/file/uid/{uid}` | Retrieve file metadata by UID. |
| GET | `/api/file/v1/file/download/{uid}` | Download file bytes by UID. |
| PUT | `/api/file/v1/file/uid/{uid}/retention` | Extend a file's retention window (1–14 days). |
| POST | `/api/conversion/v1/conversion` | Start a new file conversion job. |
| GET | `/api/conversion/v1/conversion/uid/{uid}` | Get the full conversion record by conversion UID. |
| GET | `/api/conversion/v1/conversion/uid/{uid}/status` | Get just the status of a conversion by UID. |
| GET | `/api/conversion/v1/conversion/search` | List and filter the caller's past conversions. |
| GET | `/api/conversion-status/ws` | WebSocket stream for real-time conversion status updates. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/file-convert-online/openapi/_original/file-convert-online-mcp-openapi.json
- **JSONSchema** — https://artifacts.apis.io/file-convert-online/json-schema/file-convert-online-conversion-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/file-convert-online/json-schema/file-convert-online-conversion-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/file-convert-online/json-schema/file-convert-online-file-dto-schema.json
- **JSONSchema** — https://artifacts.apis.io/file-convert-online/json-schema/file-convert-online-effect-schema.json
- **JSONSchema** — https://artifacts.apis.io/file-convert-online/json-schema/file-convert-online-file-format-schema.json
- **JSONSchema** — https://artifacts.apis.io/file-convert-online/json-schema/file-convert-online-envelope-schema.json

## Other FileConvert APIs (1)

- [File Convert Online API](https://apis.io/apis/file-convert-online/file-convert-online-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/file-convert-online/file-convert-online-public-agent-api-mcp-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/file-convert-online/.