---
title: "Convert a file to markdown without ingesting it"
method: POST
path: "/v1/documents/convert"
tags: ["Documents"]
---

# Convert a file to markdown without ingesting it

`POST /v1/documents/convert`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/documents/convert`
- Auth: HTTP bearer

Stateless conversion — no document row, no extraction, no field registry. Returns the markdown plus conversion metadata. Requires write scope.

## Response `200`

{ filename, markdown, source_format, page_count, table_count, vision_pages, warnings }

## Other responses

- `400`: No file provided.

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)