---
title: "Create a public converter preview"
method: POST
path: "/api/v1/tools/convert"
---

# Create a public converter preview

`POST /api/v1/tools/convert`

## Request

- Base URL: `https://applytovolunteer.com`
- URL: `https://applytovolunteer.com/api/v1/tools/convert`
- Auth: one of:
  - HTTP bearer
  - none

Public convert preview (size-capped). The API key is optional. Anonymous calls need a Turnstile token in production. A failed check is 400 with error turnstile. A missing Turnstile configuration is 503. Dev and test skip verification. Keyless agents should use /mcp or POST /a2a instead of calling this route without a token. formId and formVersionId are rejected. A key with forms:read stores the preview on that organization. A key without forms:read is treated as anonymous.

## Request body

- object: Send a url, pasted form, form, or text. formId and formVersionId are rejected. Do not send website; a non-empty string is rejected. turnstileToken is required in production.
  - `url` string: Page or file URL to grade or convert.
  - `text` string: Plain text of the form. Used when url, pasted, and form are absent.
  - `pasted` unknown
  - `form` unknown
  - `turnstileToken` string: Cloudflare Turnstile token. Required in production. Dev and test (ENVIRONMENT exactly dev or test) skip verification. A failed check is 400 with error turnstile. A missing Turnstile configuration is 503 with error turnstile_misconfigured. This token is not an org API key.

## Response `200`

Public convert preview (size-capped)

## Other responses

- `400`: The body, query, or input failed validation.
- `415`: The file type is not a PDF, Word document, or HTML page this route accepts.
- `422`: The upload contains filled-in personal data. Send a blank form.
- `429`: Too many requests from this network or organization.
- `503`: Turnstile is not configured, or a required parser is unavailable.

---

[API](https://skmtc.dev/applytovolunteer/apis/apply2volunteer-api.md) · [All operations](https://skmtc.dev/applytovolunteer/apis/apply2volunteer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/applytovolunteer/apis/apply2volunteer-api/revisions/23df1ec8c88d?raw)