---
title: "Parse + render in one call"
method: POST
path: "/v1/convert"
tags: ["Recipes"]
---

# Parse + render in one call

`POST /v1/convert`

## Request

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

Paid convenience operation. Returns the validated graph and finished HTML; optionally publishes a hosted embed.

## Request body

- object
  - `text` string
  - `imageBase64` string
  - `imageMimeType` string
  - `theme` 'classic' | 'ink' | 'editorial' | 'terminal' | 'midnight' | 'coral' | 'chalk' | 'fjord' | 'riso' | 'kraft'
  - `forceCard` boolean
  - `publishEmbed` boolean

## Response `200`

Document + HTML (+ embed URL)

---

[API](https://skmtc.dev/tabularrecipe/apis/tabular-recipe-api.md) · [All operations](https://skmtc.dev/tabularrecipe/apis/tabular-recipe-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tabularrecipe/apis/tabular-recipe-api/revisions/273485a7c044?raw)