{
  "openapi": "3.1.0",
  "info": {
    "title": "PDFConversionAPI",
    "version": "2",
    "summary": "File conversion REST API: post a file as a multipart form, get the converted files back as JSON.",
    "description": "REST API for 556 file conversions: documents, spreadsheets, presentations, images, CAD drawings, e-mail, e-books and PDF tools.\n\nSend a file to `POST /v2/convert/{from}/to/{to}` as `multipart/form-data` with `Authorization: Bearer <key>`. A successful conversion returns HTTP 200 and JSON with each output file base64-encoded in `Files[].FileData`, or a download link that works for 3 hours with `StoreFile=true`. Every request is synchronous; there are no background jobs or webhooks.\n\nGet a free key by signing in with Google or GitHub at https://app.pdfconversionapi.com. The Free plan allows 250 conversions a month, files up to 10 MB and 1 conversion at a time; paid plans raise those limits, and every plan stops at its monthly limit. [Pricing](https://pdfconversionapi.com/pricing)\n\nErrors are JSON with the status in `Code` and the reason in `Message`. Retry 429 and 503 after the `Retry-After` seconds. Every response from the API carries an `x-request-id` header.\n\nDocs: [Quickstart](https://pdfconversionapi.com/docs) · [Authentication](https://pdfconversionapi.com/docs/authentication) · [Requests](https://pdfconversionapi.com/docs/requests) · [Responses](https://pdfconversionapi.com/docs/responses) · [Errors](https://pdfconversionapi.com/docs/errors) · [Limits](https://pdfconversionapi.com/docs/limits) · [Stored files](https://pdfconversionapi.com/docs/stored-files) · [Conversions](https://pdfconversionapi.com/docs/conversions)",
    "termsOfService": "https://pdfconversionapi.com/legal/terms",
    "contact": {
      "name": "PDFConversionAPI support",
      "url": "https://pdfconversionapi.com/contact",
      "email": "support@pdfconversionapi.com"
    }
  },
  "externalDocs": {"description": "Docs", "url": "https://pdfconversionapi.com/docs"},
  "servers": [
    {"url": "https://api.pdfconversionapi.com"}
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "tags": [
    {"name": "Conversions", "description": "Convert files, and list the conversions on offer."},
    {
      "name": "Stored files",
      "description": "Results kept with `StoreFile=true`: download them, or delete them before their link expires."
    },
    {"name": "Account", "description": "Your plan and this month's usage."},
    {"name": "Service", "description": "Whether the API is up."}
  ],
  "paths": {
    "/v2/convert/{from}/to/{to}": {
      "post": {
        "operationId": "convert",
        "tags": ["Conversions"],
        "summary": "Convert a file",
        "description": "Converts the uploaded file from `{from}` to `{to}` and returns every output file in the response. The request is synchronous: the result comes back in the same HTTP response, after up to 120 seconds of conversion time, so give your client a timeout of at least 240 seconds.\n\n556 conversions are offered. `GET /v2/info` lists every valid pair, and a pair that isn't offered gets a 404 that names it. Three more paths, `file/to/pdf`, `file/to/md` and `office/to/pdf`, read the input format from the uploaded file's name.\n\nEach conversion's own parameters are listed on its page in [All conversions](https://pdfconversionapi.com/conversions). The operations below this one list them for common conversions.\n\nOnly successful conversions count toward your plan's month. [Requests](https://pdfconversionapi.com/docs/requests) · [Responses](https://pdfconversionapi.com/docs/responses) · [Errors](https://pdfconversionapi.com/docs/errors)",
        "parameters": [
          {
            "name": "from",
            "in": "path",
            "required": true,
            "description": "The format of your file, or a name for what you send, such as `images`, `file`, `office` or `data`. Case-insensitive. Aliases are read as the main name: `jpeg` as `jpg`, `jpe` as `jpg`, `jfif` as `jpg`, `tif` as `tiff`, `htm` as `html`, `markdown` as `md`, `text` as `txt`, `dicom` as `dcm`.",
            "schema": {
              "type": "string",
              "enum": ["ai", "barcode", "bmp", "csv", "data", "dcm", "dicom", "doc", "docx", "dot", "dotx", "dwg", "dxf", "email", "eml", "epub", "exr", "file", "gif", "hdr", "heic", "heif", "htm", "html", "ico", "images", "jfif", "jpe", "jpeg", "jpg", "kra", "log", "markdown", "md", "mhtml", "mobi", "msg", "numbers", "odc", "odf", "odg", "odp", "ods", "odt", "office", "ora", "pages", "pdf", "pdfa", "pdn", "png", "pnm", "potx", "pps", "ppsx", "ppt", "pptx", "psb", "psd", "pub", "qoi", "qrcode", "rtf", "svg", "text", "tga", "tif", "tiff", "txt", "vsd", "vsdx", "webp", "wpd", "xcf", "xls", "xlsb", "xlsx", "xltx", "xml", "zip"]
            },
            "example": "docx"
          },
          {
            "name": "to",
            "in": "path",
            "required": true,
            "description": "The format you want, or a tool such as `merge`, `split`, `compress`, `protect` or `ocr`. Case-insensitive; the same aliases apply.",
            "schema": {
              "type": "string",
              "enum": ["barcode", "bmp", "compress", "crop", "csv", "data", "delete-pages", "docx", "dwg", "dxf", "extract", "extract-attachments", "extract-images", "flatten", "gif", "htm", "html", "ico", "image-watermark", "jfif", "join", "jpe", "jpeg", "jpg", "json", "jxl", "markdown", "md", "merge", "meta", "metadata", "ocr", "odt", "pdf", "pdf-watermark", "pdfa", "png", "pnm", "pptx", "protect", "qrcode", "qrdata", "rasterize", "repair", "resize", "rotate", "rtf", "split", "svg", "text", "text-watermark", "tga", "tif", "tiff", "txt", "unprotect", "validate", "webp", "xls", "xlsx", "xml", "zip"]
            },
            "example": "pdf"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/ConvertForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/pdf/to/compress": {
      "post": {
        "operationId": "convertPdfToCompress",
        "tags": ["Conversions"],
        "summary": "PDF to COMPRESS",
        "description": "`pdf/to/compress` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `Linearize`: `Linearize=true` returns 400. The result is not linearized for page-at-a-time loading in browsers.\n- `PreservePdfa`: `PreservePdfa=true` returns 400. To end up with PDF/A, compress first and then send the result to `/v2/convert/pdf/to/pdfa`.\n- `RemoveMetadata`: `false` returns 400. `true`, ConvertAPI's documented default, is accepted, but document properties and XMP metadata are kept today.\n- `RemoveEmbeddedFiles`: `false` returns 400. `true`, the documented default, is accepted, but attachments are kept today.\n- `RemoveStructureInformation`: `false` returns 400. `true`, the documented default, is accepted, but accessibility tags are kept today.\n- `RemoveForms`: `true` returns 400. Form fields are kept and stay fillable.\n- `RemoveDuplicates`\n- `RemovePieceInformation`\n- `RemoveUnusedResources`\n- `Optimize`\n- `UnembedBaseFonts`: Fonts stay embedded as they were.\n- `SubsetEmbeddedFonts`: Fonts are not re-subset.",
        "externalDocs": {"description": "Compress PDF API", "url": "https://pdfconversionapi.com/pdf/compress"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/CompressForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/csv/to/pdf": {
      "post": {
        "operationId": "convertCsvToPdf",
        "tags": ["Conversions"],
        "summary": "CSV to PDF",
        "description": "`csv/to/pdf` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `Delimiter`: Only a comma is accepted; any other value returns 400. Convert semicolon or tab files to commas first.\n- `AutoFitColumns`: Columns are already sized to their longest value.",
        "externalDocs": {"description": "CSV to PDF API", "url": "https://pdfconversionapi.com/convert/csv-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/CsvToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/csv/to/xlsx": {
      "post": {
        "operationId": "convertCsvToXlsx",
        "tags": ["Conversions"],
        "summary": "CSV to XLSX",
        "description": "`csv/to/xlsx` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `CellType`: Number detection can't be switched off yet. `CellType=text` is accepted because it is the documented default; any other value returns 400.",
        "externalDocs": {"description": "CSV to XLSX API", "url": "https://pdfconversionapi.com/convert/csv-to-xlsx"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/CsvToXlsxForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/docx/to/html": {
      "post": {
        "operationId": "convertDocxToHtml",
        "tags": ["Conversions"],
        "summary": "DOCX to HTML",
        "description": "`docx/to/html` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `InlineImages`: Pictures are always embedded in the HTML as data URIs. `InlineImages=false`, which asks for separate image files, returns 400.",
        "externalDocs": {"description": "DOCX to HTML API", "url": "https://pdfconversionapi.com/convert/docx-to-html"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/DocxToHtmlForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/doc/to/html": {
      "post": {
        "operationId": "convertDocToHtml",
        "tags": ["Conversions"],
        "summary": "DOC to HTML",
        "description": "`doc/to/html` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `InlineImages`: Pictures are always embedded in the HTML as data URIs. `InlineImages=false`, which asks for separate image files, returns 400.",
        "externalDocs": {"description": "DOCX to HTML API", "url": "https://pdfconversionapi.com/convert/docx-to-html"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/DocxToHtmlForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/docx/to/pdf": {
      "post": {
        "operationId": "convertDocxToPdf",
        "tags": ["Conversions"],
        "summary": "DOCX to PDF",
        "description": "`docx/to/pdf` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `PageRange`: Convert the whole document, then keep the pages you need with `/v2/convert/pdf/to/extract`.\n- `Pdfa`: Convert first, then send the PDF to `/v2/convert/pdf/to/pdfa` for PDF/A-2b or 3b.\n- `IncludeMetadata`\n- `IncludeStructureTags`\n- `BookmarkMode`: Headings already become PDF bookmarks; the mode can't be changed yet.\n- `SubsetFonts`: Fonts are always embedded as subsets.",
        "externalDocs": {"description": "DOCX to PDF API", "url": "https://pdfconversionapi.com/convert/docx-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/DocxToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/doc/to/pdf": {
      "post": {
        "operationId": "convertDocToPdf",
        "tags": ["Conversions"],
        "summary": "DOC to PDF",
        "description": "`doc/to/pdf` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `PageRange`: Convert the whole document, then keep the pages you need with `/v2/convert/pdf/to/extract`.\n- `Pdfa`: Convert first, then send the PDF to `/v2/convert/pdf/to/pdfa` for PDF/A-2b or 3b.\n- `IncludeMetadata`\n- `IncludeStructureTags`\n- `BookmarkMode`: Headings already become PDF bookmarks; the mode can't be changed yet.\n- `SubsetFonts`: Fonts are always embedded as subsets.",
        "externalDocs": {"description": "DOCX to PDF API", "url": "https://pdfconversionapi.com/convert/docx-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/DocxToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/docx/to/png": {
      "post": {
        "operationId": "convertDocxToPng",
        "tags": ["Conversions"],
        "summary": "DOCX to PNG",
        "description": "`docx/to/png` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.",
        "externalDocs": {"description": "DOCX to PNG API", "url": "https://pdfconversionapi.com/convert/docx-to-png"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/DocxToPngForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/docx/to/jpg": {
      "post": {
        "operationId": "convertDocxToJpg",
        "tags": ["Conversions"],
        "summary": "DOCX to JPG",
        "description": "`docx/to/jpg` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.",
        "externalDocs": {"description": "DOCX to PNG API", "url": "https://pdfconversionapi.com/convert/docx-to-png"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/DocxToPngForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/doc/to/png": {
      "post": {
        "operationId": "convertDocToPng",
        "tags": ["Conversions"],
        "summary": "DOC to PNG",
        "description": "`doc/to/png` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.",
        "externalDocs": {"description": "DOCX to PNG API", "url": "https://pdfconversionapi.com/convert/docx-to-png"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/DocxToPngForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/doc/to/jpg": {
      "post": {
        "operationId": "convertDocToJpg",
        "tags": ["Conversions"],
        "summary": "DOC to JPG",
        "description": "`doc/to/jpg` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.",
        "externalDocs": {"description": "DOCX to PNG API", "url": "https://pdfconversionapi.com/convert/docx-to-png"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/DocxToPngForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/dwg/to/pdf": {
      "post": {
        "operationId": "convertDwgToPdf",
        "tags": ["Conversions"],
        "summary": "DWG to PDF",
        "description": "`dwg/to/pdf` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `SpaceToConvert`: The PDF always shows model space, and only the default value is accepted: even `SpaceToConvert=model` returns 400, so leave it out. Paper-space layouts aren't plotted yet.\n- `CustomSpaceToConvert`: A layout can't be picked by name yet, for the same reason.\n- `PageSize`: The sheet always lies sideways: US Letter (11 x 8.5 in), or A4 when the drawing's MEASUREMENT setting is metric. For another sheet size, send the PDF to `/v2/convert/pdf/to/resize`.\n- `PageOrientation`: The page is always wider than it is tall. The documented default, portrait, is accepted, but the page doesn't turn.\n- `PageWidth`: Use `PageSize=custom` on `/v2/convert/pdf/to/resize` after converting.\n- `PageHeight`: Use `PageSize=custom` on `/v2/convert/pdf/to/resize` after converting.\n- `AutoFit`: The drawing is always scaled to fit the page.\n- `ExportLayers`: Visible layers always become PDF layers; `false` returns 400.\n- `ColorSpace`: Lines keep their layer colors. Only the default, truecolors, is accepted; grayscale and monochrome output aren't available yet.",
        "externalDocs": {"description": "DWG to PDF API", "url": "https://pdfconversionapi.com/convert/dwg-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/DwgToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/dxf/to/pdf": {
      "post": {
        "operationId": "convertDxfToPdf",
        "tags": ["Conversions"],
        "summary": "DXF to PDF",
        "description": "`dxf/to/pdf` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `SpaceToConvert`: Only model space is converted, and only the default value is accepted: `SpaceToConvert=model` returns 400 too. Layouts in the DXF are skipped.\n- `CustomSpaceToConvert`: No layout can be selected yet.\n- `PageSize`: Output is a single sideways sheet: Letter (11 x 8.5 in), or A4 when the DXF's `$MEASUREMENT` header says metric. To change it, pass the PDF through `/v2/convert/pdf/to/resize`, which offers A2 to A6, Letter, Legal and custom sizes.\n- `PageOrientation`: Fixed with the long side across. Sending portrait, the documented default, doesn't change it.\n- `PageWidth`: `/v2/convert/pdf/to/resize` accepts it together with `PageSize=custom`.\n- `PageHeight`: `/v2/convert/pdf/to/resize` accepts it together with `PageSize=custom`.\n- `AutoFit`: Always on: the drawing extents are scaled to the sheet.\n- `ExportLayers`: Always on.\n- `ColorSpace`: Entities print in the colors they have in the DXF. There's no black-and-white mode yet.",
        "externalDocs": {"description": "DXF to PDF API", "url": "https://pdfconversionapi.com/convert/dxf-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/DxfToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/eml/to/pdf": {
      "post": {
        "operationId": "convertEmlToPdf",
        "tags": ["Conversions"],
        "summary": "EML to PDF",
        "description": "`eml/to/pdf` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `ConvertAttachments`: Only `false` is accepted. To convert attachments, get them as separate files from `/v2/convert/email/to/extract` and send each one to its own route.\n- `TemplateFile`: The header block has one fixed layout. `ConvertHeader=false` leaves it out.\n- `DateTimeFormat`: The Date line is always the message's own timestamp in ISO 8601 form, with the sender's UTC offset.\n- `Pdfa`: Convert first, then send the PDF to `/v2/convert/pdf/to/pdfa`. The sample's output passed through that route.",
        "externalDocs": {"description": "EML to PDF API", "url": "https://pdfconversionapi.com/convert/eml-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/EmlToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/epub/to/pdf": {
      "post": {
        "operationId": "convertEpubToPdf",
        "tags": ["Conversions"],
        "summary": "EPUB to PDF",
        "description": "`epub/to/pdf` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.",
        "externalDocs": {"description": "EPUB to PDF API", "url": "https://pdfconversionapi.com/convert/epub-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/EpubToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/heic/to/jpg": {
      "post": {
        "operationId": "convertHeicToJpg",
        "tags": ["Conversions"],
        "summary": "HEIC to JPG",
        "description": "`heic/to/jpg` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.",
        "externalDocs": {"description": "HEIC to JPG API", "url": "https://pdfconversionapi.com/convert/heic-to-jpg"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/HeicToJpgForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/heif/to/jpg": {
      "post": {
        "operationId": "convertHeifToJpg",
        "tags": ["Conversions"],
        "summary": "HEIF to JPG",
        "description": "`heif/to/jpg` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.",
        "externalDocs": {"description": "HEIC to JPG API", "url": "https://pdfconversionapi.com/convert/heic-to-jpg"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/HeicToJpgForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/heic/to/pdf": {
      "post": {
        "operationId": "convertHeicToPdf",
        "tags": ["Conversions"],
        "summary": "HEIC to PDF",
        "description": "`heic/to/pdf` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `ColorSpace`: Sending `TrueColors` is the same as leaving it out; `gray` and the other values return 400.\n- `ColorProfile`: The photo's own profile, such as Display P3, is written into the PDF.\n- `Pdfa`: Send the result to `/v2/convert/pdf/to/pdfa`.",
        "externalDocs": {"description": "HEIC to PDF API", "url": "https://pdfconversionapi.com/convert/heic-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/HeicToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/heif/to/pdf": {
      "post": {
        "operationId": "convertHeifToPdf",
        "tags": ["Conversions"],
        "summary": "HEIF to PDF",
        "description": "`heif/to/pdf` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `ColorSpace`: Sending `TrueColors` is the same as leaving it out; `gray` and the other values return 400.\n- `ColorProfile`: The photo's own profile, such as Display P3, is written into the PDF.\n- `Pdfa`: Send the result to `/v2/convert/pdf/to/pdfa`.",
        "externalDocs": {"description": "HEIC to PDF API", "url": "https://pdfconversionapi.com/convert/heic-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/HeicToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/html/to/pdf": {
      "post": {
        "operationId": "convertHtmlToPdf",
        "tags": ["Conversions"],
        "summary": "HTML to PDF",
        "description": "`html/to/pdf` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `Url`: Fetch the page in your own code and send the HTML as File. The converter loads nothing over the network, so put images in as `data:` URIs and CSS in style elements.\n- `AuthUsername`: Applies to `Url`.\n- `AuthPassword`: Applies to `Url`.\n- `Cookies`: Applies to `Url`.\n- `Headers`: Applies to `Url`.\n- `AdBlock`: Hide ad slots with `HideElements`, or strip them from the HTML before you send it.\n- `CookieConsentBlock`: Hide the banner with `HideElements`.\n- `LoadLazyContent`\n- `ShowElements`: Use `HideElements` on the parts you want left out.\n- `FixedElements`: Only the value fixed is accepted.",
        "externalDocs": {"description": "HTML to PDF API", "url": "https://pdfconversionapi.com/convert/html-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/HtmlToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/html/to/png": {
      "post": {
        "operationId": "convertHtmlToPng",
        "tags": ["Conversions"],
        "summary": "HTML to PNG",
        "description": "`html/to/png` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `Url`: Upload the HTML instead. Nothing is fetched while rendering, so embed images as `data:` URIs.\n- `AuthUsername`: Only meaningful with `Url`.\n- `AuthPassword`: Only meaningful with `Url`.\n- `Cookies`: Only meaningful with `Url`.\n- `Headers`: Only meaningful with `Url`.\n- `AdBlock`: Use `HideElements` on the ad containers.\n- `CookieConsentBlock`: Use `HideElements` on the consent banner.",
        "externalDocs": {"description": "HTML to PNG API", "url": "https://pdfconversionapi.com/convert/html-to-png"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/HtmlToPngForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/html/to/jpg": {
      "post": {
        "operationId": "convertHtmlToJpg",
        "tags": ["Conversions"],
        "summary": "HTML to JPG",
        "description": "`html/to/jpg` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `Url`: Upload the HTML instead. Nothing is fetched while rendering, so embed images as `data:` URIs.\n- `AuthUsername`: Only meaningful with `Url`.\n- `AuthPassword`: Only meaningful with `Url`.\n- `Cookies`: Only meaningful with `Url`.\n- `Headers`: Only meaningful with `Url`.\n- `AdBlock`: Use `HideElements` on the ad containers.\n- `CookieConsentBlock`: Use `HideElements` on the consent banner.",
        "externalDocs": {"description": "HTML to PNG API", "url": "https://pdfconversionapi.com/convert/html-to-png"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/HtmlToPngForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/images/to/pdf": {
      "post": {
        "operationId": "convertImagesToPdf",
        "tags": ["Conversions"],
        "summary": "IMAGES to PDF",
        "description": "`images/to/pdf` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `ColorSpace`: `TrueColors` is accepted and means the same as the default; `gray` and other values return 400.\n- `Pdfa`: Make the combined file PDF/A with `/v2/convert/pdf/to/pdfa`.",
        "externalDocs": {"description": "Images to PDF API", "url": "https://pdfconversionapi.com/convert/images-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/ImagesToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/jpg/to/pdf": {
      "post": {
        "operationId": "convertJpgToPdf",
        "tags": ["Conversions"],
        "summary": "JPG to PDF",
        "description": "`jpg/to/pdf` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `ColorSpace`: The JPEG keeps its own color model: grayscale, RGB or CMYK. `TrueColors` is accepted as the default; `gray` and other values return 400.\n- `ColorProfile`: An ICC profile inside the JPEG is copied into the PDF as the image's color space.\n- `Pdfa`: Convert first, then send the PDF to `/v2/convert/pdf/to/pdfa`.",
        "externalDocs": {"description": "JPG to PDF API", "url": "https://pdfconversionapi.com/convert/jpg-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/JpgToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/md/to/pdf": {
      "post": {
        "operationId": "convertMdToPdf",
        "tags": ["Conversions"],
        "summary": "MD to PDF",
        "description": "`md/to/pdf` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.",
        "externalDocs": {"description": "Markdown to PDF API", "url": "https://pdfconversionapi.com/convert/md-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/MdToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/md/to/html": {
      "post": {
        "operationId": "convertMdToHtml",
        "tags": ["Conversions"],
        "summary": "MD to HTML",
        "description": "`md/to/html` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.",
        "externalDocs": {"description": "Markdown to PDF API", "url": "https://pdfconversionapi.com/convert/md-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/MdToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/md/to/docx": {
      "post": {
        "operationId": "convertMdToDocx",
        "tags": ["Conversions"],
        "summary": "MD to DOCX",
        "description": "`md/to/docx` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.",
        "externalDocs": {"description": "Markdown to PDF API", "url": "https://pdfconversionapi.com/convert/md-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/MdToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/pdf/to/merge": {
      "post": {
        "operationId": "convertPdfToMerge",
        "tags": ["Conversions"],
        "summary": "PDF to MERGE",
        "description": "`pdf/to/merge` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `BookmarksTableOfContents`: The merged file has no bookmarks yet, and the bookmarks inside each input are not carried over either.\n- `PageSize`: Every page keeps the size it had in its own file. To bring pages to one paper size, send the merged PDF to `/v2/convert/pdf/to/resize` with `PageSize=letter`.\n- `PageOrientation`: Pages keep the orientation they had in their own file. To make every page portrait, send the merged PDF to `/v2/convert/pdf/to/resize` with `PageSize=letter` and `PageOrientation=portrait`; a wide page is scaled down to fit.\n- `OpenPage`: Set it in a second step with `/v2/convert/pdf/to/pdf`, which reads `OpenPage`.\n- `RemoveDuplicateFonts`: Each input keeps its own embedded fonts; two files that embed the same font both keep their copy.",
        "externalDocs": {"description": "Merge PDF API", "url": "https://pdfconversionapi.com/pdf/merge"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/MergeForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/msg/to/pdf": {
      "post": {
        "operationId": "convertMsgToPdf",
        "tags": ["Conversions"],
        "summary": "MSG to PDF",
        "description": "`msg/to/pdf` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `ConvertAttachments`: `false` is the only value accepted. `/v2/convert/email/to/extract` reads .msg files too and hands back each attachment as a file you can convert on its own route.\n- `TemplateFile`: Any value is refused; the header layout cannot be replaced.\n- `DateTimeFormat`: Any value is refused. The Date line is copied from the message's saved internet headers as written there.\n- `Pdfa`: Run the PDF through `/v2/convert/pdf/to/pdfa` afterwards.",
        "externalDocs": {"description": "MSG to PDF API", "url": "https://pdfconversionapi.com/convert/msg-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/MsgToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/pdf/to/ocr": {
      "post": {
        "operationId": "convertPdfToOcr",
        "tags": ["Conversions"],
        "summary": "PDF to OCR",
        "description": "`pdf/to/ocr` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `OcrLanguage`: Only `en` is accepted. Any other language returns 400 with \"OcrLanguage=de is not supported yet (supported: en)\".\n- `OcrQuality`: There is one recognition setting. The documented default value is accepted; any other value returns 400.\n- `PageSegmentationMode`: Page layout is detected by the model. sparseText, the default, is accepted; other values return 400.\n- `Preprocessing`: Image routes (`png`, `jpg`, `tiff` to `txt`) accept only `true`, the default.",
        "externalDocs": {"description": "OCR API for scanned PDFs", "url": "https://pdfconversionapi.com/pdf/ocr"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/OcrForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/png/to/txt": {
      "post": {
        "operationId": "convertPngToTxt",
        "tags": ["Conversions"],
        "summary": "PNG to TXT",
        "description": "`png/to/txt` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `OcrLanguage`: Only `en` is accepted. Any other language returns 400 with \"OcrLanguage=de is not supported yet (supported: en)\".\n- `OcrQuality`: There is one recognition setting. The documented default value is accepted; any other value returns 400.\n- `PageSegmentationMode`: Page layout is detected by the model. sparseText, the default, is accepted; other values return 400.\n- `Preprocessing`: Image routes (`png`, `jpg`, `tiff` to `txt`) accept only `true`, the default.",
        "externalDocs": {"description": "OCR API for scanned PDFs", "url": "https://pdfconversionapi.com/pdf/ocr"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/OcrForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/jpg/to/txt": {
      "post": {
        "operationId": "convertJpgToTxt",
        "tags": ["Conversions"],
        "summary": "JPG to TXT",
        "description": "`jpg/to/txt` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `OcrLanguage`: Only `en` is accepted. Any other language returns 400 with \"OcrLanguage=de is not supported yet (supported: en)\".\n- `OcrQuality`: There is one recognition setting. The documented default value is accepted; any other value returns 400.\n- `PageSegmentationMode`: Page layout is detected by the model. sparseText, the default, is accepted; other values return 400.\n- `Preprocessing`: Image routes (`png`, `jpg`, `tiff` to `txt`) accept only `true`, the default.",
        "externalDocs": {"description": "OCR API for scanned PDFs", "url": "https://pdfconversionapi.com/pdf/ocr"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/OcrForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/tiff/to/txt": {
      "post": {
        "operationId": "convertTiffToTxt",
        "tags": ["Conversions"],
        "summary": "TIFF to TXT",
        "description": "`tiff/to/txt` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `OcrLanguage`: Only `en` is accepted. Any other language returns 400 with \"OcrLanguage=de is not supported yet (supported: en)\".\n- `OcrQuality`: There is one recognition setting. The documented default value is accepted; any other value returns 400.\n- `PageSegmentationMode`: Page layout is detected by the model. sparseText, the default, is accepted; other values return 400.\n- `Preprocessing`: Image routes (`png`, `jpg`, `tiff` to `txt`) accept only `true`, the default.",
        "externalDocs": {"description": "OCR API for scanned PDFs", "url": "https://pdfconversionapi.com/pdf/ocr"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/OcrForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/pdf/to/docx": {
      "post": {
        "operationId": "convertPdfToDocx",
        "tags": ["Conversions"],
        "summary": "PDF to DOCX",
        "description": "`pdf/to/docx` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `Layout`: Only the default, flowing, is accepted.\n- `Annotations`\n- `OcrMode`: This step reads the PDF's text layer only. Send scans to `/v2/convert/pdf/to/ocr` first.\n- `OcrLanguage`\n- `OcrEngine`",
        "externalDocs": {"description": "PDF to DOCX API", "url": "https://pdfconversionapi.com/convert/pdf-to-docx"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/PdfToDocxForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/pdf/to/jpg": {
      "post": {
        "operationId": "convertPdfToJpg",
        "tags": ["Conversions"],
        "summary": "PDF to JPG",
        "description": "`pdf/to/jpg` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `FitToSize`\n- `Scale`: Set the size with `ImageResolution`, `ImageWidth` or `ImageHeight`.\n- `Rotate`: Turn the pages first with `/v2/convert/pdf/to/rotate`. Rotate refuses signed PDFs, and PDFs with permission restrictions unless you send their owner password in `Password`; this route draws both as they are.\n- `CropTo`\n- `BitDepth`\n- `CompressionLevel`: Use `ImageQuality` to trade size for quality.",
        "externalDocs": {"description": "PDF to JPG API", "url": "https://pdfconversionapi.com/convert/pdf-to-jpg"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/PdfToJpgForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/pdf/to/md": {
      "post": {
        "operationId": "convertPdfToMd",
        "tags": ["Conversions"],
        "summary": "PDF to MD",
        "description": "`pdf/to/md` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `Images`: Only the default, embed, is accepted, and even then images are left out. Get them as files from `/v2/convert/pdf/to/extract-images`.\n- `ListBulletChar`: Only the default, -, is accepted. Bullets currently come out as the PDF's own • character.\n- `DetectHeadings`: Headings are always detected; turning detection off is not supported yet.",
        "externalDocs": {"description": "PDF to Markdown API", "url": "https://pdfconversionapi.com/convert/pdf-to-md"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/PdfToMdForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/pdf/to/png": {
      "post": {
        "operationId": "convertPdfToPng",
        "tags": ["Conversions"],
        "summary": "PDF to PNG",
        "description": "`pdf/to/png` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `FitToSize`\n- `Scale`: Set the size with `ImageResolution`, `ImageWidth` or `ImageHeight`.\n- `Rotate`: Rotate the pages with `/v2/convert/pdf/to/rotate`, then render. Rotate refuses signed PDFs, and refuses restricted PDFs unless `Password` carries the owner password; this route draws both kinds as they are.\n- `CropTo`\n- `BitDepth`\n- `CompressionLevel`: Send the PNGs to `/v2/convert/png/to/compress` for smaller files with the same pixels.",
        "externalDocs": {"description": "PDF to PNG API", "url": "https://pdfconversionapi.com/convert/pdf-to-png"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/PdfToPngForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/pdf/to/txt": {
      "post": {
        "operationId": "convertPdfToTxt",
        "tags": ["Conversions"],
        "summary": "PDF to TXT",
        "description": "`pdf/to/txt` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `PageRange`: Cut the pages out first with `/v2/convert/pdf/to/extract` and `PageRange`, then extract the text of that PDF. Extract refuses signed PDFs, and refuses PDFs with permission restrictions unless you send the owner password.\n- `OcrMode`: This route never runs OCR. For scans, use `/v2/convert/pdf/to/ocr` with `OutputType=txt`.\n- `OcrLanguage`\n- `SplitPages`: `/v2/convert/pdf/to/ocr` with `OutputType=txt` puts a form feed between pages.\n- `RemoveHeadersFooters`\n- `RemoveFootnotes`\n- `RemoveTables`\n- `IncludeFormatting`",
        "externalDocs": {"description": "PDF to TXT API", "url": "https://pdfconversionapi.com/convert/pdf-to-txt"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/PdfToTxtForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/pdf/to/pdfa": {
      "post": {
        "operationId": "convertPdfToPdfa",
        "tags": ["Conversions"],
        "summary": "PDF to PDFA",
        "description": "`pdf/to/pdfa` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `Linearize`: Only `false` is accepted; the output is not linearized.\n- `InvoiceFormat`: Only none. ZUGFeRD and Factur-X invoices can't be built yet.\n- `InvoiceFile`: Files can't be attached in this step. Files already attached to the PDF are kept with `PdfaVersion=pdfA3b`.",
        "externalDocs": {"description": "PDF to PDF/A API", "url": "https://pdfconversionapi.com/pdf/pdfa"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/PdfaForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/pdfa/to/validate": {
      "post": {
        "operationId": "convertPdfaToValidate",
        "tags": ["Conversions"],
        "summary": "PDFA to VALIDATE",
        "description": "`pdfa/to/validate` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `Linearize`: Only `false` is accepted; the output is not linearized.\n- `InvoiceFormat`: Only none. ZUGFeRD and Factur-X invoices can't be built yet.\n- `InvoiceFile`: Files can't be attached in this step. Files already attached to the PDF are kept with `PdfaVersion=pdfA3b`.",
        "externalDocs": {"description": "PDF to PDF/A API", "url": "https://pdfconversionapi.com/pdf/pdfa"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/PdfaForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/png/to/jpg": {
      "post": {
        "operationId": "convertPngToJpg",
        "tags": ["Conversions"],
        "summary": "PNG to JPG",
        "description": "`png/to/jpg` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.",
        "externalDocs": {"description": "PNG to JPG API", "url": "https://pdfconversionapi.com/convert/png-to-jpg"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/PngToJpgForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/png/to/pdf": {
      "post": {
        "operationId": "convertPngToPdf",
        "tags": ["Conversions"],
        "summary": "PNG to PDF",
        "description": "`png/to/pdf` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `ColorSpace`: `TrueColors`, which keeps the colors as they are, is accepted like `default`; other values return 400. Grayscale PNGs stay grayscale; color and palette PNGs become RGB.\n- `ColorProfile`: A profile stored in the PNG (iCCP chunk) is carried into the PDF.\n- `Pdfa`: Run the PDF through `/v2/convert/pdf/to/pdfa` afterwards.",
        "externalDocs": {"description": "PNG to PDF API", "url": "https://pdfconversionapi.com/convert/png-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/PngToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/pptx/to/pdf": {
      "post": {
        "operationId": "convertPptxToPdf",
        "tags": ["Conversions"],
        "summary": "PPTX to PDF",
        "description": "`pptx/to/pdf` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `PageRange`: Refused for .pptx. Convert the deck, then send the PDF to `/v2/convert/pdf/to/extract` with `PageRange`. The .ppt route accepts `PageRange` directly.\n- `ConvertSpeakerNotes`: Notes are never printed; only Disabled is accepted.\n- `Pdfa`: Send the finished PDF to `/v2/convert/pdf/to/pdfa`. Our sample came back as valid PDF/A-2b.\n- `EmbedFonts`: Fonts are always embedded, as subsets.\n- `IncludeMetadata`",
        "externalDocs": {"description": "PPTX to PDF API", "url": "https://pdfconversionapi.com/convert/pptx-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/PptxToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/ppt/to/pdf": {
      "post": {
        "operationId": "convertPptToPdf",
        "tags": ["Conversions"],
        "summary": "PPT to PDF",
        "description": "`ppt/to/pdf` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `PageRange`: Refused for .pptx. Convert the deck, then send the PDF to `/v2/convert/pdf/to/extract` with `PageRange`. The .ppt route accepts `PageRange` directly.\n- `ConvertSpeakerNotes`: Notes are never printed; only Disabled is accepted.\n- `Pdfa`: Send the finished PDF to `/v2/convert/pdf/to/pdfa`. Our sample came back as valid PDF/A-2b.\n- `EmbedFonts`: Fonts are always embedded, as subsets.\n- `IncludeMetadata`",
        "externalDocs": {"description": "PPTX to PDF API", "url": "https://pdfconversionapi.com/convert/pptx-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/PptxToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/pdf/to/protect": {
      "post": {
        "operationId": "convertPdfToProtect",
        "tags": ["Conversions"],
        "summary": "PDF to PROTECT",
        "description": "`pdf/to/protect` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `PreservePermissions`: The input's permissions are not carried over. Set the flags you want again.\n- `RespectOwnerPassword`: To change a file that is already protected, send its owner password in `Password`.",
        "externalDocs": {"description": "Password-protect PDF API", "url": "https://pdfconversionapi.com/pdf/protect"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/ProtectForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/pdf/to/rotate": {
      "post": {
        "operationId": "convertPdfToRotate",
        "tags": ["Conversions"],
        "summary": "PDF to ROTATE",
        "description": "`pdf/to/rotate` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `AutoRotate`: `AutoRotate=true` returns 400. Pages turn only by the `Angle` you send; nothing detects sideways text.",
        "externalDocs": {"description": "Rotate PDF API", "url": "https://pdfconversionapi.com/pdf/rotate"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/RotateForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/pdf/to/split": {
      "post": {
        "operationId": "convertPdfToSplit",
        "tags": ["Conversions"],
        "summary": "PDF to SPLIT",
        "description": "`pdf/to/split` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `Mode`: Splitting is by page count only. `Mode=pagecount`, the documented default, is accepted; any other mode returns 400.\n- `Value`: Returns 400 with any value. Put the number of pages per file in `SplitByPages`.\n- `MergeOutput`: Every part comes back as its own entry in Files[].",
        "externalDocs": {"description": "Split PDF API", "url": "https://pdfconversionapi.com/pdf/split"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/SplitForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/svg/to/pdf": {
      "post": {
        "operationId": "convertSvgToPdf",
        "tags": ["Conversions"],
        "summary": "SVG to PDF",
        "description": "`svg/to/pdf` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.",
        "externalDocs": {"description": "SVG to PDF API", "url": "https://pdfconversionapi.com/convert/svg-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/SvgToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/svg/to/png": {
      "post": {
        "operationId": "convertSvgToPng",
        "tags": ["Conversions"],
        "summary": "SVG to PNG",
        "description": "`svg/to/png` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.",
        "externalDocs": {"description": "SVG to PNG API", "url": "https://pdfconversionapi.com/convert/svg-to-png"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/SvgToPngForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/pdf/to/unprotect": {
      "post": {
        "operationId": "convertPdfToUnprotect",
        "tags": ["Conversions"],
        "summary": "PDF to UNPROTECT",
        "description": "`pdf/to/unprotect` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.",
        "externalDocs": {"description": "Remove PDF password API", "url": "https://pdfconversionapi.com/pdf/unlock"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/UnlockForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/pdf/to/text-watermark": {
      "post": {
        "operationId": "convertPdfToTextWatermark",
        "tags": ["Conversions"],
        "summary": "PDF to TEXT-WATERMARK",
        "description": "`pdf/to/text-watermark` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `HorizontalAlignment`: The mark is always centered. Move it with `OffsetX` and `OffsetY`.\n- `VerticalAlignment`: Same as `HorizontalAlignment`: only `center` is accepted.\n- `FontName`: Text is set in Helvetica, the PDF standard font with the same letter widths as Arial. arial, the default, is accepted.\n- `StrokeColor`: Text is drawn filled, without an outline.\n- `StrokeWidth`\n- `TextRenderingMode`: filltext and fillstroke are accepted and both draw filled text with no outline. Other modes return 400.\n- `LineSpacing`: Lines started by a line break in `Text` use the default spacing.\n- `Width`: Size text with `FontSize`, and images or PDF pages with `Scale`.\n- `Height`\n- `FontEmbed`: The font is never embedded. `true`, the default, is accepted but changes nothing (see what the routes lose, below).\n- `FontSubset`\n- `GoToLink`: The mark can't carry a link.\n- `GoToPage`\n- `PageRotation`: Documented for `image-watermark` and `pdf-watermark`; `false`, the default, is accepted.",
        "externalDocs": {"description": "PDF watermark API", "url": "https://pdfconversionapi.com/pdf/watermark"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/PdfToTextWatermarkForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/pdf/to/image-watermark": {
      "post": {
        "operationId": "convertPdfToImageWatermark",
        "tags": ["Conversions"],
        "summary": "PDF to IMAGE-WATERMARK",
        "description": "`pdf/to/image-watermark` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `HorizontalAlignment`: The mark is always centered. Move it with `OffsetX` and `OffsetY`.\n- `VerticalAlignment`: Same as `HorizontalAlignment`: only `center` is accepted.\n- `FontName`: Text is set in Helvetica, the PDF standard font with the same letter widths as Arial. arial, the default, is accepted.\n- `StrokeColor`: Text is drawn filled, without an outline.\n- `StrokeWidth`\n- `TextRenderingMode`: filltext and fillstroke are accepted and both draw filled text with no outline. Other modes return 400.\n- `LineSpacing`: Lines started by a line break in `Text` use the default spacing.\n- `Width`: Size text with `FontSize`, and images or PDF pages with `Scale`.\n- `Height`\n- `FontEmbed`: The font is never embedded. `true`, the default, is accepted but changes nothing (see what the routes lose, below).\n- `FontSubset`\n- `GoToLink`: The mark can't carry a link.\n- `GoToPage`\n- `PageRotation`: Documented for `image-watermark` and `pdf-watermark`; `false`, the default, is accepted.",
        "externalDocs": {"description": "PDF watermark API", "url": "https://pdfconversionapi.com/pdf/watermark"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/PdfToImageWatermarkForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/pdf/to/pdf-watermark": {
      "post": {
        "operationId": "convertPdfToPdfWatermark",
        "tags": ["Conversions"],
        "summary": "PDF to PDF-WATERMARK",
        "description": "`pdf/to/pdf-watermark` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `HorizontalAlignment`: The mark is always centered. Move it with `OffsetX` and `OffsetY`.\n- `VerticalAlignment`: Same as `HorizontalAlignment`: only `center` is accepted.\n- `FontName`: Text is set in Helvetica, the PDF standard font with the same letter widths as Arial. arial, the default, is accepted.\n- `StrokeColor`: Text is drawn filled, without an outline.\n- `StrokeWidth`\n- `TextRenderingMode`: filltext and fillstroke are accepted and both draw filled text with no outline. Other modes return 400.\n- `LineSpacing`: Lines started by a line break in `Text` use the default spacing.\n- `Width`: Size text with `FontSize`, and images or PDF pages with `Scale`.\n- `Height`\n- `FontEmbed`: The font is never embedded. `true`, the default, is accepted but changes nothing (see what the routes lose, below).\n- `FontSubset`\n- `GoToLink`: The mark can't carry a link.\n- `GoToPage`\n- `PageRotation`: Documented for `image-watermark` and `pdf-watermark`; `false`, the default, is accepted.",
        "externalDocs": {"description": "PDF watermark API", "url": "https://pdfconversionapi.com/pdf/watermark"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/PdfToPdfWatermarkForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/webp/to/jpg": {
      "post": {
        "operationId": "convertWebpToJpg",
        "tags": ["Conversions"],
        "summary": "WEBP to JPG",
        "description": "`webp/to/jpg` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.",
        "externalDocs": {"description": "WebP to JPG API", "url": "https://pdfconversionapi.com/convert/webp-to-jpg"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/WebpToJpgForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/xlsx/to/csv": {
      "post": {
        "operationId": "convertXlsxToCsv",
        "tags": ["Conversions"],
        "summary": "XLSX to CSV",
        "description": "`xlsx/to/csv` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.",
        "externalDocs": {"description": "XLSX to CSV API", "url": "https://pdfconversionapi.com/convert/xlsx-to-csv"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/XlsxToCsvForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/xls/to/csv": {
      "post": {
        "operationId": "convertXlsToCsv",
        "tags": ["Conversions"],
        "summary": "XLS to CSV",
        "description": "`xls/to/csv` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.",
        "externalDocs": {"description": "XLSX to CSV API", "url": "https://pdfconversionapi.com/convert/xlsx-to-csv"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/XlsxToCsvForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/xlsb/to/csv": {
      "post": {
        "operationId": "convertXlsbToCsv",
        "tags": ["Conversions"],
        "summary": "XLSB to CSV",
        "description": "`xlsb/to/csv` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.",
        "externalDocs": {"description": "XLSX to CSV API", "url": "https://pdfconversionapi.com/convert/xlsx-to-csv"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/XlsxToCsvForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/ods/to/csv": {
      "post": {
        "operationId": "convertOdsToCsv",
        "tags": ["Conversions"],
        "summary": "ODS to CSV",
        "description": "`ods/to/csv` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.",
        "externalDocs": {"description": "XLSX to CSV API", "url": "https://pdfconversionapi.com/convert/xlsx-to-csv"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/XlsxToCsvForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/xlsx/to/pdf": {
      "post": {
        "operationId": "convertXlsxToPdf",
        "tags": ["Conversions"],
        "summary": "XLSX to PDF",
        "description": "`xlsx/to/pdf` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `AutoFitColumns`\n- `ThousandsSeparator`: Numbers print with the cell formats saved in the file.\n- `DecimalSeparator`\n- `DateFormat`: Dates print with the cell formats saved in the file.\n- `IncludeMetadata`",
        "externalDocs": {"description": "XLSX to PDF API", "url": "https://pdfconversionapi.com/convert/xlsx-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/XlsxToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/xls/to/pdf": {
      "post": {
        "operationId": "convertXlsToPdf",
        "tags": ["Conversions"],
        "summary": "XLS to PDF",
        "description": "`xls/to/pdf` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `AutoFitColumns`\n- `ThousandsSeparator`: Numbers print with the cell formats saved in the file.\n- `DecimalSeparator`\n- `DateFormat`: Dates print with the cell formats saved in the file.\n- `IncludeMetadata`",
        "externalDocs": {"description": "XLSX to PDF API", "url": "https://pdfconversionapi.com/convert/xlsx-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/XlsxToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/xlsb/to/pdf": {
      "post": {
        "operationId": "convertXlsbToPdf",
        "tags": ["Conversions"],
        "summary": "XLSB to PDF",
        "description": "`xlsb/to/pdf` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `AutoFitColumns`\n- `ThousandsSeparator`: Numbers print with the cell formats saved in the file.\n- `DecimalSeparator`\n- `DateFormat`: Dates print with the cell formats saved in the file.\n- `IncludeMetadata`",
        "externalDocs": {"description": "XLSX to PDF API", "url": "https://pdfconversionapi.com/convert/xlsx-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/XlsxToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/convert/ods/to/pdf": {
      "post": {
        "operationId": "convertOdsToPdf",
        "tags": ["Conversions"],
        "summary": "ODS to PDF",
        "description": "`ods/to/pdf` with the parameters it reads. The rules for every conversion are in `POST /v2/convert/{from}/to/{to}`.\n\n**Not supported yet.** Setting one of these to anything but its default returns 400:\n\n- `AutoFitColumns`\n- `ThousandsSeparator`: Numbers print with the cell formats saved in the file.\n- `DecimalSeparator`\n- `DateFormat`: Dates print with the cell formats saved in the file.\n- `IncludeMetadata`",
        "externalDocs": {"description": "XLSX to PDF API", "url": "https://pdfconversionapi.com/convert/xlsx-to-pdf"},
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {"$ref": "#/components/schemas/XlsxToPdfForm"}
            }
          }
        },
        "responses": {
          "200": {"$ref": "#/components/responses/Converted"},
          "400": {"$ref": "#/components/responses/BadRequest"},
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "404": {"$ref": "#/components/responses/NotFound"},
          "413": {"$ref": "#/components/responses/PayloadTooLarge"},
          "422": {"$ref": "#/components/responses/Unprocessable"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"},
          "503": {"$ref": "#/components/responses/ServiceUnavailable"},
          "504": {"$ref": "#/components/responses/Timeout"}
        }
      }
    },
    "/v2/info": {
      "get": {
        "operationId": "listConversions",
        "tags": ["Conversions"],
        "summary": "List every conversion",
        "description": "Every conversion the API offers, as one JSON array, under main format names only. No key needed, and it doesn't count toward any limit. The list changes only when a new version of the API is deployed, so fetch it once and keep it. `file/to/pdf`, `file/to/md` and `office/to/pdf` work without being in the list. [Conversions](https://pdfconversionapi.com/docs/conversions)",
        "security": [],
        "responses": {
          "200": {
            "description": "556 entries.",
            "headers": {
              "x-request-id": {"$ref": "#/components/headers/RequestId"}
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {"$ref": "#/components/schemas/ConversionInfo"}
                },
                "example": [
                  {"From": "docx", "To": "pdf", "Title": "DOCX to PDF", "Category": "Document", "Inputs": "one"}
                ]
              }
            }
          }
        }
      }
    },
    "/v2/usage": {
      "get": {
        "operationId": "getUsage",
        "tags": ["Account"],
        "summary": "Your plan and this month's usage",
        "description": "The key's plan, its limits and this month's count. It uses no conversion, so it is also the way to check that a key works (200) or not (401). It counts toward the rate limit of 600 requests a minute. [Check your usage](https://pdfconversionapi.com/docs/authentication#check-your-usage)",
        "responses": {
          "200": {
            "description": "The plan and this month's usage.",
            "headers": {
              "x-request-id": {"$ref": "#/components/headers/RequestId"}
            },
            "content": {
              "application/json": {
                "schema": {"$ref": "#/components/schemas/Usage"},
                "example": {
                  "Plan": "Free",
                  "Included": 250,
                  "Used": 12,
                  "Remaining": 238,
                  "Overage": false,
                  "Running": 0,
                  "ConcurrentLimit": 1,
                  "MaxUploadMB": 10,
                  "PeriodStart": "2026-11-01T00:00:00.000Z",
                  "PeriodEnd": "2026-12-01T00:00:00.000Z"
                }
              }
            }
          },
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "403": {"$ref": "#/components/responses/Forbidden"},
          "429": {"$ref": "#/components/responses/TooManyRequests"},
          "500": {"$ref": "#/components/responses/InternalError"}
        }
      }
    },
    "/v2/d/{id}/{name}": {
      "get": {
        "operationId": "downloadStoredFile",
        "tags": ["Stored files"],
        "summary": "Download a stored file",
        "description": "The file behind a `Url` from a `StoreFile=true` conversion. No key needed: anyone with the link can download the file until it expires, 3 hours after it was stored, so treat it like a password. Downloads don't use up the link and don't count toward the rate limit. Range requests aren't supported; every download is the whole file. [Stored files](https://pdfconversionapi.com/docs/stored-files)",
        "security": [],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The `FileId` from the conversion response.",
            "schema": {"type": "string", "pattern": "^[0-9a-f]{32}$"},
            "example": "32001ff088d5c35e10e4bc6f6ddf09a9"
          },
          {
            "name": "name",
            "in": "path",
            "required": true,
            "description": "The `FileName`, percent-encoded. Any other name gets a 404.",
            "schema": {"type": "string", "minLength": 1, "maxLength": 255},
            "example": "season-guide-1.jpg"
          }
        ],
        "responses": {
          "200": {
            "description": "The file. `Content-Type` is set from the extension (for example `application/pdf`, `image/jpeg`); other types are sent as `application/octet-stream`.",
            "headers": {
              "x-request-id": {"$ref": "#/components/headers/RequestId"},
              "Content-Disposition": {
                "description": "`attachment` with the file's name, so a browser saves it.",
                "schema": {"type": "string"},
                "example": "attachment; filename*=UTF-8''season-guide-1.jpg"
              },
              "Content-Length": {
                "description": "The size in bytes, the same as `FileSize`.",
                "schema": {"type": "integer"}
              },
              "Cache-Control": {
                "schema": {"type": "string", "const": "private, no-store"}
              },
              "Content-Security-Policy": {
                "description": "Scripts in an HTML or SVG result don't run if it is opened in a browser.",
                "schema": {"type": "string", "const": "sandbox"}
              }
            },
            "content": {
              "*/*": {
                "schema": {"type": "string", "format": "binary", "contentMediaType": "application/octet-stream"}
              }
            }
          },
          "404": {
            "description": "The link has expired, the file was deleted, or the id or name is wrong.",
            "headers": {
              "x-request-id": {"$ref": "#/components/headers/RequestId"}
            },
            "content": {
              "application/json": {
                "schema": {"$ref": "#/components/schemas/Error"},
                "example": {"Code": 404, "Message": "not found"}
              }
            }
          },
          "500": {"$ref": "#/components/responses/InternalError"}
        }
      }
    },
    "/v2/d/{id}": {
      "delete": {
        "operationId": "deleteStoredFile",
        "tags": ["Stored files"],
        "summary": "Delete a stored file early",
        "description": "Deletes one stored file at once; send one request per `FileId`. It needs a key of the account that created the file. Deletes don't count toward the rate limit. [Delete a file early](https://pdfconversionapi.com/docs/stored-files#delete-a-file-early)",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "The `FileId` from the conversion response.",
            "schema": {"type": "string", "pattern": "^[0-9a-f]{32}$"},
            "example": "32001ff088d5c35e10e4bc6f6ddf09a9"
          }
        ],
        "responses": {
          "204": {
            "description": "Deleted. No body; the link now answers 404.",
            "headers": {
              "x-request-id": {"$ref": "#/components/headers/RequestId"}
            }
          },
          "401": {"$ref": "#/components/responses/Unauthorized"},
          "404": {
            "description": "Nothing to delete: the id is unknown, the file was already deleted or cleaned up, or it belongs to another account. The answer is the same in each case.",
            "headers": {
              "x-request-id": {"$ref": "#/components/headers/RequestId"}
            },
            "content": {
              "application/json": {
                "schema": {"$ref": "#/components/schemas/Error"},
                "example": {"Code": 404, "Message": "not found"}
              }
            }
          },
          "500": {"$ref": "#/components/responses/InternalError"}
        }
      }
    },
    "/health": {
      "get": {
        "operationId": "health",
        "tags": ["Service"],
        "summary": "Service status",
        "description": "Says that the API is up and how many conversions it offers. No key needed.",
        "security": [],
        "responses": {
          "200": {
            "description": "The API is up.",
            "headers": {
              "x-request-id": {"$ref": "#/components/headers/RequestId"}
            },
            "content": {
              "application/json": {
                "schema": {"$ref": "#/components/schemas/Health"},
                "example": {"Status": "ok", "Converters": 556}
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Your API key, in `Authorization: Bearer <key>`. Get a free key by signing in with Google or GitHub at https://app.pdfconversionapi.com. A key in the URL's query string is not read. Keys are 16 to 256 characters. [Authentication](https://pdfconversionapi.com/docs/authentication)"
      }
    },
    "headers": {
      "RequestId": {
        "description": "A random id for this request, on every response from the API, errors and downloads included. Send it with any question about a request. A response without it came from the network in front of the API. [Errors](https://pdfconversionapi.com/docs/errors#the-request-id-x-request-id)",
        "schema": {"type": "string", "format": "uuid"}
      },
      "RetryAfter": {
        "description": "Seconds to wait before retrying, a whole number. Treat it as the shortest wait and add jitter. [Retry-After](https://pdfconversionapi.com/docs/errors#retry-after)",
        "schema": {"type": "integer", "minimum": 1}
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "description": "Most errors have this JSON body. `Message` is written for a person and can change between releases: branch on the status code, and log the message.",
        "required": ["Code", "Message"],
        "properties": {
          "Code": {"type": "integer", "description": "The HTTP status, repeated."},
          "Message": {"type": "string", "description": "The reason, naming the parameter, the limit or the file at fault."}
        }
      },
      "OutputFile": {
        "type": "object",
        "description": "One output file. `FileData` holds the file; with `StoreFile=true`, `Url` and `FileId` take its place.",
        "required": ["FileName", "FileExt", "FileSize"],
        "properties": {
          "FileName": {
            "type": "string",
            "description": "The output's name, extension included. It never contains a slash or a backslash."
          },
          "FileExt": {"type": "string", "description": "The extension in lower case, without the dot: `pdf`, `jpg`, `xlsx`."},
          "FileSize": {"type": "integer", "minimum": 0, "description": "The file's size in bytes, after decoding."},
          "FileData": {
            "type": "string",
            "contentEncoding": "base64",
            "description": "The file, base64-encoded with the standard alphabet and `=` padding, on one line. Left out with `StoreFile=true`."
          },
          "Url": {
            "type": "string",
            "format": "uri",
            "description": "Only with `StoreFile=true`: `https://api.pdfconversionapi.com/v2/d/{FileId}/{FileName}`, the name percent-encoded. It works for 3 hours and needs no key. Use it as it comes; don't build it yourself."
          },
          "FileId": {
            "type": "string",
            "pattern": "^[0-9a-f]{32}$",
            "description": "Only with `StoreFile=true`: the stored file's id, 32 hex characters. `DELETE /v2/d/{FileId}` deletes the file early."
          }
        },
        "oneOf": [
          {
            "required": ["FileData"]
          },
          {
            "required": ["Url", "FileId"]
          }
        ]
      },
      "ConversionResult": {
        "type": "object",
        "required": ["ConversionCost", "ConversionTime", "Files"],
        "properties": {
          "ConversionCost": {
            "type": "integer",
            "description": "Always 1. One request is one conversion, however many pages or files come back."
          },
          "ConversionTime": {
            "type": "number",
            "description": "Seconds the conversion took on our side, rounded to the millisecond. It leaves out the upload, any wait for a free conversion slot, and the transfer of the response."
          },
          "Files": {
            "type": "array",
            "minItems": 1,
            "description": "One entry per output file, in a fixed order. Page images are numbered by their page in the source (`report-2.jpg`), split parts from 1. [Responses](https://pdfconversionapi.com/docs/responses#several-output-files)",
            "items": {"$ref": "#/components/schemas/OutputFile"}
          }
        }
      },
      "ConversionInfo": {
        "type": "object",
        "required": ["From", "To", "Title", "Category", "Inputs"],
        "properties": {
          "From": {
            "type": "string",
            "description": "The source format's main name, in lower case: the `{from}` part of the path."
          },
          "To": {
            "type": "string",
            "description": "The target format, or a tool such as `merge` or `compress`: the `{to}` part of the path."
          },
          "Title": {"type": "string", "description": "A label: both names in capitals, joined by \"to\"."},
          "Category": {
            "type": "string",
            "enum": ["Archive", "Barcode", "CAD", "Chart", "Document", "Drawing", "Email", "Formula", "Image", "Markdown", "OCR", "PDF", "PDF Document", "PDF Image", "PDF Tools", "Presentation", "Spreadsheet", "Web", "eBook"],
            "description": "The conversion's group."
          },
          "Inputs": {
            "type": "string",
            "enum": ["one", "many", "optional"],
            "description": "Which file fields the conversion reads. `one`: exactly one file in `File`. `many`: up to 50 files, each in a `Files` field. `optional`: text in the `Data` parameter, or one text file in `File`."
          }
        }
      },
      "Usage": {
        "type": "object",
        "required": ["Plan", "Included", "Used", "Remaining", "Overage", "Running", "ConcurrentLimit", "MaxUploadMB", "PeriodStart", "PeriodEnd"],
        "properties": {
          "Plan": {"type": "string", "description": "The plan's name, for example `Free`."},
          "Included": {"type": "integer", "description": "Successful conversions included each calendar month (UTC)."},
          "Used": {
            "type": "integer",
            "description": "Successful conversions so far this month. Failed requests aren't counted."
          },
          "Remaining": {
            "type": ["integer", "null"],
            "description": "What is left of `Included` this month. It would be null only on a plan that converts past `Included`, and no plan does."
          },
          "Overage": {
            "type": "boolean",
            "description": "Whether the plan keeps converting past `Included`. `false` on every plan: conversions stop when `Included` is used up."
          },
          "Running": {"type": "integer", "description": "Conversions running for the account right now."},
          "ConcurrentLimit": {"type": "integer", "description": "How many conversions the plan runs at the same time."},
          "MaxUploadMB": {
            "type": "integer",
            "description": "The largest request the plan accepts, all files and fields together, in MB (1 MB is 1,048,576 bytes)."
          },
          "PeriodStart": {"type": "string", "format": "date-time", "description": "Start of this month's count, UTC."},
          "PeriodEnd": {
            "type": "string",
            "format": "date-time",
            "description": "End of this month's count, UTC. The count starts again then."
          }
        }
      },
      "Health": {
        "type": "object",
        "required": ["Status", "Converters"],
        "properties": {
          "Status": {"type": "string", "const": "ok"},
          "Converters": {"type": "integer", "description": "How many conversions the API offers."}
        }
      },
      "ConvertForm": {
        "type": "object",
        "description": "The request body: a `multipart/form-data` form. JSON, base64 inside JSON and `application/x-www-form-urlencoded` bodies are not supported; they get a 400 with a plain-text body.\n\n- File fields: `File` for one file; `Files`, repeated once per file (or numbered `Files[0]`, `Files[1]`), for several. `File` and `Files` are interchangeable, and field names are case-insensitive. Files are used in the order they appear in the body. Any other field that carries a file name is read as a named file, such as `ImageFile`. At most 50 files.\n- Every other field is a parameter, sent as text. Names: letters, digits and `_`, up to 64 characters, case-insensitive; sent twice, the last value wins. Values: up to 65,536 bytes. At most 100 parameters, named file fields included. An empty value counts as not sent.\n- Yes/no values accept `true` or `false`, `1` or `0`, `yes` or `no`, `on` or `off`, in any case. Numbers are checked against a range, and a value out of range gets a 400 that names the parameter.\n- Only form fields are read: parameters in the query string are ignored.\n- A documented option that this conversion can't apply gets a 400 naming it when you set it to a value other than its default. A parameter that isn't an option of the conversion is ignored.\n- The whole request, files and fields together, can be up to your plan's upload size: 10 MB on the Free plan and 100 MB on paid plans.\n- `File` must hold the file's bytes. A URL sent as text is read as the file; nothing is downloaded for you.\n\n[Requests](https://pdfconversionapi.com/docs/requests) · [Limits](https://pdfconversionapi.com/docs/limits)",
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert, for conversions that take one file. Its name becomes the output's name with the new extension (`report.docx` comes back as `report.pdf`); `FileName` sets another. `file/to/pdf`, `file/to/md` and `office/to/pdf` read the input format from this name, so it must end in the format, such as `report.docx`; send the `File` part first."
          },
          "Files": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "string",
              "format": "binary",
              "contentMediaType": "application/octet-stream",
              "description": "One input file."
            },
            "description": "For `pdf/to/merge`, `images/to/pdf`, `images/to/join` and `file/to/zip`: one `Files` part per file, in the order they are used. `pdf/to/merge` and `images/to/join` need at least two. The number in `Files[n]` does not reorder them."
          },
          "ImageFile": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "For `pdf/to/image-watermark`: the image stamped on each page (PNG, JPEG, TIFF, GIF or BMP)."
          },
          "OverlayFile": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "For `pdf/to/pdf-watermark`: the PDF whose page is stamped on each page (`OverlayPage` picks the page)."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the output, without the extension. Letters, digits, spaces, `-`, `_` and `.` are kept, anything else becomes `_`, and the name is cut at 120 characters. With several outputs it replaces the part before the number. Files unpacked from an archive or a PDF keep their own names."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "`true` returns a download link (`Url` and `FileId`) for each output instead of `FileData`. The link works for 3 hours. [Stored files](https://pdfconversionapi.com/docs/stored-files)"
          },
          "PageRange": {
            "type": "string",
            "examples": ["2-3", "1-3,5", "4-", "-2", "last", "5-last"],
            "description": "Pages to use, counted from 1, for conversions that work page by page. Pages come back in document order, each once. The end of a range may be past the last page; a single page or the start of a range may not (400). A conversion that can't apply `PageRange` refuses any value but its default with a 400."
          },
          "Password": {
            "type": "string",
            "description": "The password that opens a protected input file. PDF tools that rewrite a restricted PDF need the owner password."
          },
          "Data": {
            "type": "string",
            "description": "For `data/to/qrcode` and `data/to/barcode`: the text to encode. A text file in `File` works too."
          }
        },
        "additionalProperties": {"type": "string", "description": "Other parameters of the conversion, as text."}
      },
      "CompressForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "Preset": {
            "type": "string",
            "enum": ["none", "web", "ebook", "text", "printer", "lossless", "archive"],
            "default": "none",
            "description": "Target resolution and JPEG quality for color and grayscale images. `web`: 72 ppi, quality 60. `ebook` and `text`: 150 ppi, quality 70. `printer`: 300 ppi, quality 85. `none`: 150 ppi, quality 80. `lossless` and `archive` leave every image as it is and only rewrite the file's structure."
          },
          "ImageResolution": {
            "type": "integer",
            "minimum": 36,
            "maximum": 1200,
            "default": 150,
            "description": "Target pixels per inch, measured at the size each image is drawn on the page; replaces the preset's value. Only images above 1.5 times the target are resampled: at 300, the sample's two 467 ppi pictures came down to 300 ppi and its 350 ppi picture kept its pixels."
          },
          "ImageQuality": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 80,
            "description": "JPEG quality for re-encoded images; replaces the preset's value. Images below the resampling threshold are re-encoded at this quality too, but an image is only replaced when the new version is smaller."
          },
          "Password": {
            "type": "string",
            "description": "Opens a PDF that needs a password. With the open password of a file that restricts printing, copying or editing, the compressed copy comes back encrypted with the same password, method and restrictions (we checked AES-256). When the open password allows everything, as on a file locked with only `UserPassword`, the copy comes back with no password. With the owner password, it comes back with no password and no restrictions. A file locked only with an owner password needs no `Password` here and keeps its restrictions, also when a wrong password is sent with it. If such a file allows everything, the copy comes back with no protection at all, with or without `Password`."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the result, without the extension. Without it the result has the same name as your upload, so set it if you save next to the original."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Send back a download URL in `Files[].Url` instead of `FileData`. The URL works for 3 hours."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `pdf/to/compress`: the parameters listed on https://pdfconversionapi.com/pdf/compress. Other parameters are sent as text."
      },
      "CsvToPdfForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "PdfaVersion": {
            "type": "string",
            "enum": ["none", "pdfA1b", "pdfA2b", "pdfA3b"],
            "default": "none",
            "description": "Write the table as PDF/A in the version you name. Any other value returns 400 with the list above."
          },
          "Pdfa": {
            "type": "boolean",
            "default": false,
            "description": "Shorthand for PDF/A-1b. `PdfaVersion` takes priority when both are sent."
          },
          "PageSize": {
            "type": "string",
            "enum": ["default", "letter", "lettersmall", "tabloid", "ledger", "legal", "statement", "executive", "a3", "a4", "a4small", "a5", "b4", "b5"],
            "default": "default",
            "description": "Paper for every printed page. `default` prints on A4 (595 x 842 pt). `letter` gives 612 x 792 pt pages, which held 48 rows of our 89-row test file on the first page instead of 52."
          },
          "PageOrientation": {
            "type": "string",
            "enum": ["default", "portrait", "landscape"],
            "default": "default",
            "description": "`default` prints portrait. `landscape` turns the page, so more columns fit across: our 11-column test file printed 8 columns per page instead of 5."
          },
          "FitToPage": {
            "type": "boolean",
            "default": false,
            "description": "Shrink the table to one page wide, with as many pages down as the rows need. Our 11-column test file fit on one page at 89 rows and took 3 pages at 300 rows. When both are sent, `FitToPage` wins over `Scale`."
          },
          "Scale": {
            "type": "integer",
            "minimum": 10,
            "maximum": 300,
            "default": 100,
            "description": "Print size in percent. At 50, the 11-column, 89-row test file printed on one page instead of 6."
          },
          "HeaderOnEachPage": {
            "type": "boolean",
            "default": false,
            "description": "Repeat the first row, your column names, at the top of every page. Without it the names print only on the first page of each set of columns."
          },
          "PageRange": {
            "type": "string",
            "description": "Keep only some pages of the printed table. A range may end past the last page, but a page that doesn't exist returns 400 with the page count. You can't drop pages and ask for PDF/A in the same request.\n\nValues: e.g. `1-2,4` or `3-last`."
          },
          "FileName": {
            "type": "string",
            "description": "Name of the returned PDF, minus the extension. By default `inventory-count.csv` returns `inventory-count.pdf`."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Answer with a download URL instead of the PDF bytes. The URL works for 3 hours."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `csv/to/pdf`: the parameters listed on https://pdfconversionapi.com/convert/csv-to-pdf. Other parameters are sent as text."
      },
      "CsvToXlsxForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "Delimiter": {
            "type": "string",
            "default": ",",
            "description": "The character between fields. Use ; for files from spreadsheets set to a European locale and tab for TSV. Two or more characters, or a non-ASCII character such as §, return 400.\n\nValues: One ASCII character, or `tab` (send `tab` or `\\t`)."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the workbook, without the extension. Without it the .xlsx takes the uploaded file's name."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a download link instead of the file. The link expires after 3 hours and the file is then deleted."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `csv/to/xlsx`: the parameters listed on https://pdfconversionapi.com/convert/csv-to-xlsx. Other parameters are sent as text."
      },
      "DocxToHtmlForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "IncludeMarkup": {
            "type": "boolean",
            "default": false,
            "description": "Add the document's comments at the end of the page, in a section headed Comments, each with its author and the words it was attached to. The sample has no comments, so its HTML is the same either way."
          },
          "UpdateFields": {
            "type": "boolean",
            "default": false,
            "description": "Recalculate fields before the HTML is written. In our test, a cross-reference whose stored text was out of date came out with the current text, and a stale table of contents was rebuilt from the headings."
          },
          "UpdateTableOfContents": {
            "type": "boolean",
            "default": false,
            "description": "Same effect as `UpdateFields`. The engine refreshes every field in one pass, so any of the three switches turns it on."
          },
          "UpdateReferences": {"type": "boolean", "default": false, "description": "Same effect as `UpdateFields`."},
          "Password": {
            "type": "string",
            "description": "Opens a .docx that needs a password to open. Without it, or with a wrong one, the API returns 422 \"the input file is password-protected\". A password-protected copy of the sample, sent with its password, gave the same 36,873-byte HTML as the unprotected file. A password sent with an unprotected file is ignored."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the HTML file, without the extension. `FileName=handbook-7` returns `handbook-7.html`; without it the file takes the uploaded file's name."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a download link instead of the file. The link expires after 3 hours and the file is then deleted."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `docx/to/html`, `doc/to/html`: the parameters listed on https://pdfconversionapi.com/convert/docx-to-html. Other parameters are sent as text."
      },
      "DocxToPdfForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "UpdateFields": {
            "type": "boolean",
            "default": false,
            "description": "Rebuild the table of contents and refresh cross-references (page references and the like) before the PDF is written. Page counts and DATE fields are filled in with or without it."
          },
          "UpdateTableOfContents": {
            "type": "boolean",
            "default": false,
            "description": "Same effect as `UpdateFields`. The engine refreshes every field in one pass, so any of the three switches turns it on."
          },
          "UpdateReferences": {"type": "boolean", "default": false, "description": "Same effect as `UpdateFields`."},
          "IncludeMarkup": {
            "type": "boolean",
            "default": false,
            "description": "Print comments beside each page and show tracked changes, like the Print Markup setting in Word. Without it, comments are left out and tracked insertions print as plain text."
          },
          "Password": {
            "type": "string",
            "description": "The open password of a protected .docx. The file is decrypted before it is drawn, and the PDF comes back without a password. Leave it out, or send a wrong one, and the answer is 422 \"the input file is password-protected\". Our encrypted copy of the sample gave the same 3 pages, text and bookmarks as the plain file."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the output file, without the extension. Without it the PDF takes the uploaded file's name."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a download link instead of the file. The link expires after 3 hours and the file is then deleted."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `docx/to/pdf`, `doc/to/pdf`: the parameters listed on https://pdfconversionapi.com/convert/docx-to-pdf. Other parameters are sent as text."
      },
      "DocxToPngForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "ImageResolution": {
            "type": "integer",
            "minimum": 36,
            "maximum": 600,
            "default": 150,
            "description": "Pixels per inch of page. A Letter page comes out 850 × 1,100 at 100 (the sample) and 1,275 × 1,650 at the default. ConvertAPI uses 200 when this is left out, so set it explicitly if you are moving code over. When you send it, the value is also written into the file: the sample's PNGs say 100 DPI."
          },
          "ImageWidth": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20000,
            "description": "Width of each page image in pixels. The page is drawn at the scale this width needs, not drawn at `ImageResolution` and resampled. `ImageWidth=800` gives an 800 × 1,035 image of the sample's Letter page; the height follows the page's proportions."
          },
          "ImageHeight": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20000,
            "description": "Height of each page image in pixels: `ImageHeight=500` gives 386 × 500. With both sizes the page fits inside the box, so 800 × 800 gives 618 × 800."
          },
          "ScaleProportions": {
            "type": "boolean",
            "default": true,
            "description": "With `false` and both sizes, the page is stretched to exactly that box: 800 × 800 from a Letter page, with the text stretched wider."
          },
          "ScaleIfLarger": {
            "type": "boolean",
            "default": false,
            "description": "With `true`, sizes only shrink. A page already smaller than the size you ask for keeps the size `ImageResolution` gives: `ImageWidth=2000` left the sample's first page at 1,275 × 1,650 (150 DPI)."
          },
          "ScaleImage": {
            "type": "boolean",
            "default": true,
            "description": "With `false`, the page is drawn at `ImageResolution` and cut to `ImageWidth` × `ImageHeight` from its top-left corner instead of scaled. 500 × 300 at 150 DPI kept the top margin and the left part of the sample's banner."
          },
          "ColorSpace": {
            "type": "string",
            "enum": ["default", "rgb", "gray", "monochrome"],
            "default": "default",
            "description": "Pages come back as RGB PNGs with no alpha channel, so `default` and `rgb` give the same file: page 1 at 72 DPI is 151,579 bytes either way. `gray` writes one 8-bit gray channel (55,501 bytes for that page), and adds an alpha channel only when `TransparentColor` is sent. `monochrome` makes every pixel pure black or white, split at mid-gray, which took the same page down to 15,785 bytes. `cmyk` returns 400 \"ColorSpace cmyk is not supported yet; use rgb, gray or monochrome\"."
          },
          "ImageInterpolation": {
            "type": "boolean",
            "default": false,
            "description": "Accepted for compatibility. Pages drawn to an `ImageWidth` are smoothed the same way either way: `true` and `false` gave byte-identical files."
          },
          "PageRange": {
            "type": "string",
            "description": "Draw only these pages; each file keeps its page number, so `PageRange=2` returns `program-guide-2.png`. A range may end past the last page, but a page that doesn't exist returns 400 with the document's page count.\n\nValues: Pages and ranges such as `2`, `1-3`, `2-` or `2-last` (to the end)."
          },
          "ImageQuality": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 85,
            "description": "JPEG quality, for `docx/to/jpg` and `doc/to/jpg`. The sample's two JPG pages at 150 DPI are 407,350 bytes at 85 and 280,641 at 50. ConvertAPI's default is 75. PNG ignores it."
          },
          "BackgroundColor": {
            "type": "string",
            "description": "Color painted behind each page before it is drawn; left out, pages are white. A value that is not a color returns 400.\n\nValues: `white`, `black`, `red`, `green`, `blue`, `gray`, `#RRGGBB` or `R,G,B`."
          },
          "TransparentColor": {
            "type": "string",
            "description": "PNG only: every pixel of exactly this color becomes transparent. Smoothed pixels at the edges of letters are not exactly white, so they stay opaque and show as a light fringe on a dark backdrop.\n\nValues: `white`, `black`, `red`, `green`, `blue`, `gray`, `#RRGGBB` or `R,G,B`."
          },
          "UpdateFields": {
            "type": "boolean",
            "default": false,
            "description": "Rebuild the table of contents and refresh cross-references before the pages are drawn. In our test, a table of contents saved with one stale entry was drawn with all three headings, dot leaders and page numbers. Without it, the stored entries are drawn."
          },
          "UpdateTableOfContents": {
            "type": "boolean",
            "default": false,
            "description": "Same effect as `UpdateFields`; any of the three switches turns the refresh on."
          },
          "UpdateReferences": {"type": "boolean", "default": false, "description": "Same effect as `UpdateFields`."},
          "IncludeMarkup": {
            "type": "boolean",
            "default": false,
            "description": "Draw comments in balloons in the right margin and show tracked changes, as the PDF route does with the same option. The page content is scaled down to make room for the balloons. Without it, the images show the final text and no comments."
          },
          "Password": {
            "type": "string",
            "description": "Open password of a protected .docx. Our encrypted copy of the sample, sent with its password, gave the same two PNGs byte for byte. Without it, or with a wrong one: 422 \"the input file is password-protected\"."
          },
          "FileName": {
            "type": "string",
            "description": "Stem for the page files: `FileName=fall-guide` gives `fall-guide-1.png` and `fall-guide-2.png`. Without it, the uploaded file's name is used."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Store the images and return one download link per page instead of the data. Links expire after 3 hours."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `docx/to/png`, `docx/to/jpg`, `doc/to/png`, `doc/to/jpg`: the parameters listed on https://pdfconversionapi.com/convert/docx-to-png. Other parameters are sent as text."
      },
      "DwgToPdfForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the PDF, without the extension. Without it the PDF takes the uploaded drawing's name."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a download link instead of the file. The link expires after 3 hours and the file is then deleted."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `dwg/to/pdf`: the parameters listed on https://pdfconversionapi.com/convert/dwg-to-pdf. Other parameters are sent as text."
      },
      "DxfToPdfForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "FileName": {
            "type": "string",
            "description": "Output name without the extension, for example a part number and revision. When it's missing, the PDF is named after the DXF."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a download link instead of the file. The link expires after 3 hours and the file is then deleted."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `dxf/to/pdf`: the parameters listed on https://pdfconversionapi.com/convert/dxf-to-pdf. Other parameters are sent as text."
      },
      "EmlToPdfForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "ConvertHeader": {
            "type": "boolean",
            "default": true,
            "description": "Print the subject as a heading with the From, To, Cc and Date lines under it. With `false` the PDF starts with the message body; the attachment list at the end is still printed."
          },
          "PageSize": {
            "type": "string",
            "description": "Paper for every page. Left out, it is A4 (210 x 297 mm); send `letter` for 8.5 x 11 in, as the sample does.\n\nValues: `a0` to `a9`, `b0` to `b5`, `letter`, `legal`, `ledger`.\n\nDefault: a4."
          },
          "PageOrientation": {
            "type": "string",
            "enum": ["portrait", "landscape"],
            "default": "portrait",
            "description": "Turns the paper sideways. Use it for newsletters built wider than the page: in our test a 900 px wide table was cut off on upright Letter and fit whole on Letter turned sideways."
          },
          "PageWidth": {
            "type": "integer",
            "minimum": 10,
            "maximum": 30000,
            "description": "Paper width in millimeters, overriding the width `PageSize` gives.\n\nValues: 10 to 30000 (mm)."
          },
          "PageHeight": {
            "type": "integer",
            "minimum": 10,
            "maximum": 30000,
            "description": "Paper height in millimeters, overriding the height `PageSize` gives. A long message continues onto more pages of this height.\n\nValues: 10 to 30000 (mm)."
          },
          "MarginTop": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 5,
            "description": "Space above the content on each page, in millimeters. The body adds its own 8 px of padding inside the margins, as a browser does.\n\nValues: 0 to 500 (mm)."
          },
          "MarginRight": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 5,
            "description": "Space to the right of the content, in millimeters.\n\nValues: 0 to 500 (mm)."
          },
          "MarginBottom": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 5,
            "description": "Space below the content, in millimeters.\n\nValues: 0 to 500 (mm)."
          },
          "MarginLeft": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 5,
            "description": "Space to the left of the content, in millimeters. Margins that leave no room for content return 400.\n\nValues: 0 to 500 (mm)."
          },
          "IgnoreAttachmentErrors": {
            "type": "boolean",
            "default": false,
            "description": "Accepted so existing requests keep working, and has no effect: attachments are only listed, so there is no attachment conversion to fail."
          },
          "Merge": {
            "type": "boolean",
            "default": true,
            "description": "Accepted and has no effect, for the same reason. The result is always one PDF of the message."
          },
          "FileName": {
            "type": "string",
            "description": "Name of the returned PDF, without the extension. By default it is the .eml file's name with .pdf in place of .eml."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Get a download URL in `Files[].Url` instead of base64 data. The link stops working after 3 hours."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `eml/to/pdf`: the parameters listed on https://pdfconversionapi.com/convert/eml-to-pdf. Other parameters are sent as text."
      },
      "EpubToPdfForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "PageSize": {
            "type": "string",
            "description": "Paper size for every page, matched in any case. Pages are always portrait; this route has no orientation option.\n\nValues: `a0` to `a9`, `b0` to `b5`, `letter`, `legal`, `ledger`.\n\nDefault: letter."
          },
          "BaseFontSize": {
            "type": "number",
            "minimum": 1,
            "maximum": 50,
            "default": 12,
            "description": "Size of body text in points. Text the book sizes in em or percent scales with it. Sizes in pt, px or rem stay as the book set them (rem stays relative to 12 pt), and a font size the book sets on its html element replaces this one.\n\nValues: 1 to 50 (points)."
          },
          "MarginTop": {
            "type": "number",
            "minimum": 0,
            "maximum": 200,
            "default": 40,
            "description": "Page margin at the top, in points (72 to the inch). Decimals are accepted. Margins from the book's own CSS are added inside it.\n\nValues: 0 to 200 (points)."
          },
          "MarginBottom": {
            "type": "number",
            "minimum": 0,
            "maximum": 200,
            "default": 40,
            "description": "Page margin at the bottom, in points.\n\nValues: 0 to 200 (points)."
          },
          "MarginLeft": {
            "type": "number",
            "minimum": 0,
            "maximum": 200,
            "default": 40,
            "description": "Page margin on the left, in points. Unless the book's CSS sets a body margin, the text starts 6 pt further in (the default body margin).\n\nValues: 0 to 200 (points)."
          },
          "MarginRight": {
            "type": "number",
            "minimum": 0,
            "maximum": 200,
            "default": 40,
            "description": "Page margin on the right, in points, with the same 6 pt default body margin inside it.\n\nValues: 0 to 200 (points)."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the output file, without the extension. Without it the PDF takes the uploaded book's name."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a download link instead of the file. The link expires after 3 hours and the file is then deleted."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `epub/to/pdf`: the parameters listed on https://pdfconversionapi.com/convert/epub-to-pdf. Other parameters are sent as text."
      },
      "HeicToJpgForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "ImageWidth": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20000,
            "description": "Width of the JPEG in pixels. On its own, the height keeps the photo's proportions: the 4032 x 3024 sample sent with 1600 comes back 1600 x 1200. The resize uses a Lanczos3 filter."
          },
          "ImageHeight": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20000,
            "description": "Height in pixels. With `ImageWidth` as well, the photo is fitted inside the box: 1000 x 1000 gives 1000 x 750 for a 4:3 photo."
          },
          "ScaleProportions": {
            "type": "boolean",
            "default": true,
            "description": "Set to `false` to stretch the photo to exactly `ImageWidth` x `ImageHeight`. It only matters when a width or height is in the request; sent without one it is accepted and changes nothing."
          },
          "ScaleIfLarger": {
            "type": "boolean",
            "default": false,
            "description": "Set to `true` so the resize can only shrink. A photo smaller than the requested size keeps its own size; without this, `ImageWidth=6000` enlarges a 4032-pixel photo. Without a width or height in the request it changes nothing."
          },
          "ScaleImage": {
            "type": "boolean",
            "default": true,
            "description": "Set to `false` to crop instead of resizing: the JPEG keeps the top-left `ImageWidth` x `ImageHeight` pixels of the photo. Without a width or height, nothing is cropped."
          },
          "ImageQuality": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 85,
            "description": "JPEG encoder quality. We default to 85 where ConvertAPI documents 75; send `ImageQuality=75` to match ConvertAPI's documented default."
          },
          "ColorSpace": {
            "type": "string",
            "enum": ["default", "rgb", "gray", "monochrome"],
            "default": "default",
            "description": "`gray` writes a one-channel JPEG: the sample came back at 90,311 bytes instead of 142,189. `monochrome` turns each pixel black or white before encoding; JPEG compression then leaves a few near-black and near-white values (97.5% of the sample's pixels decode to exactly 0 or 255). `rgb` changes nothing, and `cmyk` returns 400."
          },
          "ImageResolution": {
            "type": "integer",
            "minimum": 10,
            "maximum": 800,
            "description": "Writes this DPI into the JPEG's JFIF header without touching the pixels: the sample sent with 300 is still 1600 x 1200 and reports 300 DPI. Left out, the JPEG has no DPI. The photo's own resolution tag is not carried over either way."
          },
          "ImageInterpolation": {
            "type": "boolean",
            "default": false,
            "description": "Accepted for ConvertAPI compatibility. Resizing always uses Lanczos3, so `true` and `false` returned byte-identical files."
          },
          "AlphaColor": {
            "type": "string",
            "default": "white",
            "description": "Color placed behind transparent pixels before the JPEG is written. It matters only for HEIC files with an alpha channel: in a test file with a transparent left half, `AlphaColor=red` filled that half with red.\n\nValues: `white`, `black`, `red`, `green`, `blue`, `gray`, `#RRGGBB` or `R,G,B`."
          },
          "FileName": {
            "type": "string",
            "description": "Output name without .jpg. IMG_4021.heic becomes IMG_4021.jpg unless you set this."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a link to the JPEG (valid for 3 hours) in `Files[].Url` instead of base64 data."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `heic/to/jpg`, `heif/to/jpg`: the parameters listed on https://pdfconversionapi.com/convert/heic-to-jpg. Other parameters are sent as text."
      },
      "HeicToPdfForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "PageSize": {
            "type": "string",
            "enum": ["default", "auto", "a3", "a4", "a5", "letter", "legal"],
            "default": "default",
            "description": "Paper for the page. The default makes the page as large as the photo at 96 pixels per inch, which for a 12-megapixel phone photo is 31.5 x 42 in. Pick a sheet and the photo is shrunk to fit it and centered."
          },
          "PageOrientation": {
            "type": "string",
            "enum": ["default", "portrait", "landscape"],
            "default": "default",
            "description": "Lays the chosen sheet on its long side, for photos taken with the phone held sideways. The values `default` and `portrait` keep the sheet upright. Has no effect without `PageSize`."
          },
          "Rotate": {
            "type": "integer",
            "minimum": -360,
            "maximum": 360,
            "description": "Degrees to turn the photo clockwise, on top of the rotation stored in the HEIC. On Letter, 90 lays the upright sample on its side, shrunk to 612 x 459 pt and centered; 45 tilts it inside the page with white corners. Without `PageSize` the page takes the turned size (3024 x 2268 pt for 90)."
          },
          "MarginHorizontal": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 0,
            "description": "White space left and right of the photo, in millimeters. With 24 mm here and in `MarginVertical`, the sample on Letter is drawn 476 x 635 pt. Without `PageSize` the page grows by the margins instead. Margins that leave no room for the photo return 400.\n\nValues: 0 to 500 (mm)."
          },
          "MarginVertical": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 0,
            "description": "White space above and below the photo, in millimeters.\n\nValues: 0 to 500 (mm)."
          },
          "FileName": {
            "type": "string",
            "description": "Name of the PDF without the extension; by default it is the HEIC's own name."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Get a download URL for the PDF instead of base64 data. The URL works for 3 hours."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `heic/to/pdf`, `heif/to/pdf`: the parameters listed on https://pdfconversionapi.com/convert/heic-to-pdf. Other parameters are sent as text."
      },
      "HtmlToPdfForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "PageSize": {
            "type": "string",
            "description": "Paper size. Letter is 8.5 x 11 in; names are matched in any case.\n\nValues: `a0` to `a9`, `b0` to `b5`, `letter`, `legal`, `ledger`.\n\nDefault: letter."
          },
          "PageOrientation": {
            "type": "string",
            "enum": ["portrait", "landscape"],
            "default": "portrait",
            "description": "Which way the paper is turned. Turning it sideways swaps width and height, so Letter prints at 11 x 8.5 in."
          },
          "PageWidth": {
            "type": "integer",
            "minimum": 10,
            "maximum": 30000,
            "description": "Custom paper width in millimeters. Replaces the width that `PageSize` sets.\n\nValues: 10 to 30000 (mm)."
          },
          "PageHeight": {
            "type": "integer",
            "minimum": 10,
            "maximum": 30000,
            "description": "Custom paper height in millimeters. Replaces the height that `PageSize` sets.\n\nValues: 10 to 30000 (mm)."
          },
          "MarginTop": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 10,
            "description": "Top margin in millimeters. A Header template prints inside it.\n\nValues: 0 to 500 (mm)."
          },
          "MarginRight": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 10,
            "description": "Right margin in millimeters.\n\nValues: 0 to 500 (mm)."
          },
          "MarginBottom": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 10,
            "description": "Bottom margin in millimeters. A Footer template prints inside it.\n\nValues: 0 to 500 (mm)."
          },
          "MarginLeft": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 10,
            "description": "Left margin in millimeters. If the margins leave no room for content, the request gets a 400.\n\nValues: 0 to 500 (mm)."
          },
          "PageRange": {
            "type": "string",
            "description": "Keep only these pages of the printed result. `last` is the last page, so `2-last` and `2-` both run to the end. A range may end past the last page and stops there; a page or range start past the end returns 400, such as \"PageRange asks for page 5, but the document has 3 pages\".\n\nValues: e.g. `1-3,5`, `2-` or `2-last`."
          },
          "Header": {
            "type": "string",
            "description": "HTML template printed in the top margin of every page. Elements with the class `pageNumber` or `totalPages` are filled in. A template that uses `title`, `date` or `url` sends the page to the browser engine, which fills those too. Since the page is uploaded, `url` prints the placeholder address `http://document.invalid/`, not where the page came from."
          },
          "Footer": {
            "type": "string",
            "description": "HTML template for the bottom margin, with the same placeholders as `Header`. The template does not inherit the page's CSS, so give it its own font and size."
          },
          "CssMediaType": {
            "type": "string",
            "enum": ["screen", "print"],
            "default": "screen",
            "description": "Which `@media` rules apply. A page that has `@media` rules is printed by the browser engine with the default `screen` value; with `print` it stays in the in-process engine, which applies print rules."
          },
          "HideElements": {"type": "string", "description": "CSS selector. Matching elements are left out of the PDF (display: none)."},
          "AvoidBreakElements": {
            "type": "string",
            "description": "CSS selector. Page breaks avoid falling inside matching elements, such as a totals block or a signature box."
          },
          "BreakBeforeElements": {"type": "string", "description": "CSS selector. Each matching element starts on a new page."},
          "BreakAfterElements": {"type": "string", "description": "CSS selector. A new page starts after each matching element."},
          "UserCss": {
            "type": "string",
            "description": "Extra CSS applied after the page's own style sheets. Handy for print tweaks you don't want in the page itself."
          },
          "JavaScript": {
            "type": "boolean",
            "default": true,
            "description": "Set to `false` to print a page that contains scripts without running them. The page then stays in the in-process engine."
          },
          "UserJs": {
            "type": "string",
            "description": "`JavaScript` to run in the page after it loads and before it is printed. The request goes to the browser engine."
          },
          "WaitElement": {
            "type": "string",
            "description": "CSS selector to wait for before printing, for pages that build their content with scripts. The request goes to the browser engine. If the element never appears, the request fails with 400 when the time limit runs out."
          },
          "ConversionDelay": {
            "type": "integer",
            "minimum": 0,
            "maximum": 30,
            "default": 0,
            "description": "Seconds to wait after the page loads before printing. It applies to pages printed by the browser engine; a page without scripts has nothing to wait for and is printed at once.\n\nValues: 0 to 30 (seconds)."
          },
          "Background": {
            "type": "boolean",
            "default": true,
            "description": "Print background colors and images. `false` sends the page to the browser engine, which prints without them."
          },
          "Scale": {
            "type": "integer",
            "minimum": 10,
            "maximum": 200,
            "default": 100,
            "description": "Zoom for the printed page, like the scale box in a browser's print dialog. Any value other than 100 is printed by the browser engine.\n\nValues: 10 to 200 (%)."
          },
          "RespectViewport": {
            "type": "boolean",
            "default": false,
            "description": "`true` lays the page out at `ViewportWidth`, as on a desktop screen, and shrinks it to fit the paper (printed by the browser engine). The default lays the page out for the paper width, as a browser's Save as PDF does. ConvertAPI defaults to `true`, so send `RespectViewport=true` if you are moving from there and want the same layout."
          },
          "ViewportWidth": {
            "type": "integer",
            "minimum": 200,
            "maximum": 4000,
            "default": 1366,
            "description": "Browser window width in CSS pixels. Scripts read it as innerWidth, and `RespectViewport=true` lays the page out at this width. The in-process engine lays pages out for the paper and does not use it.\n\nValues: 200 to 4000 (px)."
          },
          "ViewportHeight": {
            "type": "integer",
            "minimum": 200,
            "maximum": 4000,
            "default": 1024,
            "description": "Browser window height in CSS pixels, which scripts read as innerHeight. Not used by the in-process engine.\n\nValues: 200 to 4000 (px)."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the PDF, without the extension. Without it the PDF takes the uploaded file's name."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a download link instead of the file. The link expires after 3 hours."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `html/to/pdf`: the parameters listed on https://pdfconversionapi.com/convert/html-to-pdf. Other parameters are sent as text."
      },
      "HtmlToPngForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "ViewportWidth": {
            "type": "integer",
            "minimum": 200,
            "maximum": 4000,
            "default": 1366,
            "description": "Width the page is laid out at, in CSS pixels. The image is this wide unless you crop, zoom or resize it.\n\nValues: 200 to 4000 (px)."
          },
          "ViewportHeight": {
            "type": "integer",
            "minimum": 200,
            "maximum": 4000,
            "default": 1024,
            "description": "Browser window height. A browser engine capture is at least this tall; the in-process engine ignores it and captures the content's own height.\n\nValues: 200 to 4000 (px)."
          },
          "CropX": {
            "type": "integer",
            "minimum": 0,
            "maximum": 16384,
            "description": "Left edge of the area to keep, counted from the left of the page.\n\nValues: 0 to 16384 (px)."
          },
          "CropY": {
            "type": "integer",
            "minimum": 0,
            "maximum": 16384,
            "description": "Top edge of the area to keep, counted from the top of the page. A crop that starts outside the page returns 400.\n\nValues: 0 to 16384 (px)."
          },
          "CropWidth": {
            "type": "integer",
            "minimum": 1,
            "maximum": 16384,
            "description": "Width of the area to keep.\n\nValues: 1 to 16384 (px)."
          },
          "CropHeight": {
            "type": "integer",
            "minimum": 1,
            "maximum": 16384,
            "description": "Height of the area to keep. It cuts and never pads: in the in-process engine, a page shorter than `CropHeight` comes out at its own height.\n\nValues: 1 to 16384 (px)."
          },
          "CropElement": {
            "type": "string",
            "description": "CSS selector. The image is cut to the border box of the first matching element. Captured by the browser engine; a selector that matches nothing returns 400."
          },
          "Zoom": {
            "type": "number",
            "minimum": 0.1,
            "maximum": 10,
            "default": 1,
            "description": "CSS zoom applied to the whole page. Captured by the browser engine. Double `ViewportWidth` and set `Zoom=2` for a sharp 2x image."
          },
          "TransparentBackground": {
            "type": "boolean",
            "default": false,
            "description": "Where the page paints no background, leave the PNG transparent instead of white. JPG has no transparency, so those areas are filled with white, or with `BackgroundColor`."
          },
          "BackgroundColor": {
            "type": "string",
            "default": "white",
            "description": "JPG only: the color that fills transparent areas when `TransparentBackground=true`. A value that is not a color returns 400.\n\nValues: `#RRGGBB`, `R,G,B`, `white`, `black`, `red`, `green`, `blue`, `gray`."
          },
          "ImageWidth": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20000,
            "description": "Resize the finished image to this width. Alone, the height follows the aspect ratio.\n\nValues: 1 to 20000 (px)."
          },
          "ImageHeight": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20000,
            "description": "Resize to this height. With `ImageWidth` too, the image is fitted inside both, keeping its shape: 600 x 600 turns the 1200 x 630 sample into 600 x 315.\n\nValues: 1 to 20000 (px)."
          },
          "ScaleProportions": {
            "type": "boolean",
            "default": true,
            "description": "With `ImageWidth` and `ImageHeight` both set, `false` stretches the image to exactly that size. Sent without a size, it is accepted and changes nothing."
          },
          "ImageQuality": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 85,
            "description": "JPEG quality for `/to/jpg`. Lower values give smaller files with more compression artifacts. ConvertAPI's default is 75; send `ImageQuality=75` to match it."
          },
          "ColorSpace": {
            "type": "string",
            "enum": ["default", "rgb", "gray", "monochrome"],
            "default": "default",
            "description": "`gray` writes one gray channel: the sample card drops from 205,545 to 80,865 bytes as PNG, and to 63,331 bytes as JPG. `monochrome` turns every pixel black or white (14,366 bytes): the card's dark gradient comes out solid black, with the text, logo and bars in white. `rgb` drops the alpha channel when every pixel is opaque: the card comes back as a 196,941-byte RGB PNG with the same pixels. With `TransparentBackground=true` the alpha stays. `cmyk` returns 400."
          },
          "ImageResolution": {
            "type": "integer",
            "minimum": 10,
            "maximum": 800,
            "description": "Only labels the file with a DPI: PNG gets a pHYs chunk and JPG a JFIF density. The pixels stay as the viewport and crop make them, so `ImageResolution=144` still gives a 1200 x 630 card. Left out, the file has no DPI."
          },
          "HideElements": {
            "type": "string",
            "description": "CSS selector. Matching elements are hidden before the capture, for cookie bars, chat buttons or anything else you don't want in the picture."
          },
          "UserCss": {
            "type": "string",
            "description": "Extra CSS added after the page's own styles, for example to swap a theme or bump a font size for the snapshot."
          },
          "CssMediaType": {
            "type": "string",
            "enum": ["screen", "print"],
            "default": "screen",
            "description": "Which `@media` rules apply. Images use `screen` rules; if the page has `@media` rules and you ask for `print`, the capture is done by the browser engine."
          },
          "JavaScript": {
            "type": "boolean",
            "default": true,
            "description": "`false` draws a page that contains scripts without running them, in the in-process engine."
          },
          "UserJs": {
            "type": "string",
            "description": "Script to run in the loaded page before the capture. Captured by the browser engine."
          },
          "WaitElement": {
            "type": "string",
            "description": "CSS selector to wait for before the capture, so content a script adds late is in the image. Captured by the browser engine."
          },
          "ConversionDelay": {
            "type": "integer",
            "minimum": 0,
            "maximum": 30,
            "default": 0,
            "description": "Extra seconds to wait after load before a browser engine capture. Pages drawn in process are captured straight away.\n\nValues: 0 to 30 (seconds)."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the image, without the extension. Without it the image takes the uploaded file's name."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a download link instead of the image data. The link expires after 3 hours."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `html/to/png`, `html/to/jpg`: the parameters listed on https://pdfconversionapi.com/convert/html-to-png. Other parameters are sent as text."
      },
      "ImagesToPdfForm": {
        "type": "object",
        "required": ["Files"],
        "properties": {
          "Files": {
            "type": "array",
            "minItems": 1,
            "maxItems": 50,
            "items": {
              "type": "string",
              "format": "binary",
              "contentMediaType": "application/octet-stream",
              "description": "One input file."
            },
            "description": "One `Files` part per file, in the order they are used."
          },
          "PageSize": {
            "type": "string",
            "enum": ["default", "auto", "a3", "a4", "a5", "letter", "legal"],
            "default": "default",
            "description": "One sheet size for every page. Left at `default`, each page gets the size of its own image (96 pixels per inch), so pages in the same PDF can differ. A named size gives uniform pages; each image is shrunk to fit if needed and centered."
          },
          "PageOrientation": {
            "type": "string",
            "enum": ["default", "portrait", "landscape"],
            "default": "default",
            "description": "Applies to all pages at once, and only together with a named `PageSize`; `default` and `portrait` are the same. Mixed portrait and wide photos can't get different orientations in one request."
          },
          "Rotate": {
            "type": "integer",
            "minimum": -360,
            "maximum": 360,
            "description": "Degrees to turn every image clockwise; one value applies to all pages. Left empty, each image follows its own EXIF orientation flag, and any number, `0` included, replaces the flags. With `PageSize=letter` and 90, the three sample receipts lie on their sides: the taxi receipt and the hotel folio shrink to the 612 pt page width, and the smaller parking stub turns at its own size, 570 x 360 pt."
          },
          "MarginHorizontal": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 0,
            "description": "White space left and right of every image, in millimeters. On a named sheet the image is fitted inside the margins: 20 mm on Letter narrowed the taxi receipt from 594 to 499 pt. Without `PageSize`, each page grows by the margins instead.\n\nValues: 0 to 500 (mm)."
          },
          "MarginVertical": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 0,
            "description": "White space above and below every image, in millimeters. Margins that leave no room for an image return 400.\n\nValues: 0 to 500 (mm)."
          },
          "FileName": {
            "type": "string",
            "description": "Name of the combined PDF, without the extension. If omitted, the PDF is named after the first image in the request."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Respond with a URL to the PDF instead of its bytes. The URL stops working after 3 hours, and the file is deleted."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `images/to/pdf`: the parameters listed on https://pdfconversionapi.com/convert/images-to-pdf. Other parameters are sent as text."
      },
      "JpgToPdfForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "PageSize": {
            "type": "string",
            "enum": ["default", "auto", "a3", "a4", "a5", "letter", "legal"],
            "default": "default",
            "description": "Paper size of the page. With `default` or `auto` the page is the image's pixel size at 96 pixels per inch. With a named size the image is scaled down to fit, centered, and never enlarged."
          },
          "PageOrientation": {
            "type": "string",
            "enum": ["default", "portrait", "landscape"],
            "default": "default",
            "description": "Turns a named `PageSize` on its side (Letter becomes 11 x 8.5 in). The values `default` and `portrait` both keep it upright. It changes nothing when the page follows the image size."
          },
          "Rotate": {
            "type": "integer",
            "minimum": -360,
            "maximum": 360,
            "description": "Degrees to turn the photo clockwise. Left empty, the photo's EXIF orientation flag decides; any number, `0` included, replaces the flag. The JPEG bytes stay as they are and the page draws them turned. On Letter, 90 lays the sample receipt on its side at 612 x 473 pt; add `PageOrientation=landscape` and it fills the sideways sheet."
          },
          "MarginHorizontal": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 0,
            "description": "White space left and right of the photo, in millimeters. On Letter, 19 mm on every side draws the sample at 504 x 653 pt. Without `PageSize` the page grows instead: 10 mm all round made it 1012.94 x 1294.19 pt.\n\nValues: 0 to 500 (mm)."
          },
          "MarginVertical": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 0,
            "description": "White space above and below the photo, in millimeters. Margins that leave no room for the photo return 400.\n\nValues: 0 to 500 (mm)."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the output file, without the extension. Without it the PDF takes the uploaded file's name."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a download link instead of the file. The link expires after 3 hours and the file is then deleted."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `jpg/to/pdf`: the parameters listed on https://pdfconversionapi.com/convert/jpg-to-pdf. Other parameters are sent as text."
      },
      "MdToPdfForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "PageSize": {
            "type": "string",
            "description": "Paper size, matched in any case. `a0` to `a2` and `b0` to `b2` return 400, because the layout engine handles pages no longer than 22 in (559 mm) on a side.\n\nValues: `a3` to `a9`, `b3` to `b5`, `letter`, `legal`, `ledger`.\n\nDefault: a4."
          },
          "PageOrientation": {
            "type": "string",
            "enum": ["portrait", "landscape"],
            "default": "portrait",
            "description": "Which way the paper is turned. `landscape` swaps width and height, so A4 prints at 297 x 210 mm. Any other value returns 400."
          },
          "MarginTop": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 10,
            "description": "Top margin in whole millimeters. A decimal such as 12.5 returns 400.\n\nValues: 0 to 500 (mm)."
          },
          "MarginRight": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 5,
            "description": "Right margin in millimeters.\n\nValues: 0 to 500 (mm)."
          },
          "MarginBottom": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 10,
            "description": "Bottom margin in millimeters.\n\nValues: 0 to 500 (mm)."
          },
          "MarginLeft": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 5,
            "description": "Left margin in millimeters. Margins that leave less than 12.7 mm (0.5 in) of the page for text, across or down, return 400.\n\nValues: 0 to 500 (mm)."
          },
          "FontName": {
            "type": "string",
            "enum": ["arial", "calibri", "cambria", "timesNewRoman", "courierNew"],
            "default": "arial",
            "description": "Font for body text, headings and tables, matched in any case. Each is drawn with an installed font that has the same character widths: Liberation Sans for Arial, Liberation Serif for Times New Roman, Liberation Mono for Courier New, Carlito for Calibri and Caladea for Cambria. Code stays in Liberation Mono. Other names return 400, including `Times New Roman` written with spaces."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the PDF, without the extension. Without it the PDF is named after the .md file."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a download link that expires after 3 hours, instead of the PDF itself."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `md/to/pdf`, `md/to/html`, `md/to/docx`: the parameters listed on https://pdfconversionapi.com/convert/md-to-pdf. Other parameters are sent as text."
      },
      "MergeForm": {
        "type": "object",
        "required": ["Files"],
        "properties": {
          "Files": {
            "type": "array",
            "minItems": 2,
            "maxItems": 50,
            "items": {
              "type": "string",
              "format": "binary",
              "contentMediaType": "application/octet-stream",
              "description": "One input file."
            },
            "description": "The PDFs to combine, one Files part per document. Pages are joined in the order the parts appear in the request body; numbered field names such as Files[0] and Files[1] are accepted, but the numbers are not used for sorting."
          },
          "Password": {
            "type": "string",
            "description": "One password, tried on every input. A file that needs it to open is opened with it, and a file that opens without one but restricts printing, copying or editing loses those restrictions when this is its owner password. The merged PDF has no password. A copy of the sample's terms.pdf locked with `UserPassword` merged with invoice.pdf into the same 71,741-byte file as the two unprotected originals."
          },
          "FileName": {
            "type": "string",
            "description": "Name of the merged PDF, without the extension. If you leave it out, the result is named after the first uploaded file, so a client that saves it next to the inputs would replace that file."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Respond with a download URL (`Files[].Url`) in place of the base64 data. The link stops working 3 hours after the request."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `pdf/to/merge`: the parameters listed on https://pdfconversionapi.com/pdf/merge. Other parameters are sent as text."
      },
      "MsgToPdfForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "ConvertHeader": {
            "type": "boolean",
            "default": true,
            "description": "Controls the block at the top of page 1: the subject in bold, then sender, To, Cc and Date rows. `false` drops that block and keeps the body and the attachment line."
          },
          "PageSize": {
            "type": "string",
            "description": "Named paper size. Requests that leave it out get A4 (210 x 297 mm); US offices usually want `letter`.\n\nValues: `a0` to `a9`, `b0` to `b5`, `letter`, `legal`, `ledger`.\n\nDefault: a4."
          },
          "PageOrientation": {
            "type": "string",
            "enum": ["portrait", "landscape"],
            "default": "portrait",
            "description": "Upright or sideways paper. Sideways gives a wide HTML message about 2.5 inches more room on Letter."
          },
          "PageWidth": {
            "type": "integer",
            "minimum": 10,
            "maximum": 30000,
            "description": "A custom paper width; when set it wins over the `PageSize` width.\n\nValues: 10 to 30000 (mm)."
          },
          "PageHeight": {
            "type": "integer",
            "minimum": 10,
            "maximum": 30000,
            "description": "A custom paper height; when set it wins over the `PageSize` height.\n\nValues: 10 to 30000 (mm)."
          },
          "MarginTop": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 5,
            "description": "Blank band at the top of every page. All four margins are whole millimeters.\n\nValues: 0 to 500 (mm)."
          },
          "MarginRight": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 5,
            "description": "Blank band on the right edge.\n\nValues: 0 to 500 (mm)."
          },
          "MarginBottom": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 5,
            "description": "Blank band at the foot of every page.\n\nValues: 0 to 500 (mm)."
          },
          "MarginLeft": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 5,
            "description": "Blank band on the left edge. A value over 500 is refused with 400 naming the parameter.\n\nValues: 0 to 500 (mm)."
          },
          "IgnoreAttachmentErrors": {
            "type": "boolean",
            "default": false,
            "description": "Read and then ignored. No attachment is converted here, so nothing can fail."
          },
          "Merge": {"type": "boolean", "default": true, "description": "Read and then ignored; one .msg always becomes one PDF."},
          "FileName": {
            "type": "string",
            "description": "Output name without .pdf. Left out, `order-update-4471.msg` comes back as `order-update-4471.pdf`."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Answer with a temporary link (`Files[].Url`) in place of the PDF bytes; the link lasts 3 hours."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `msg/to/pdf`: the parameters listed on https://pdfconversionapi.com/convert/msg-to-pdf. Other parameters are sent as text."
      },
      "OcrForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "OcrMode": {
            "type": "string",
            "enum": ["auto", "always", "reprocess"],
            "default": "auto",
            "description": "`auto` reads only pages that have no text yet, so the born-digital pages of a mixed file are left alone. `always` also reads pages that already have text, including pictures placed on them, and adds only words the page doesn't already contain. `reprocess` does the same as `always` today: an earlier OCR layer is kept, not replaced."
          },
          "OutputType": {
            "type": "string",
            "enum": ["pdf", "txt"],
            "default": "pdf",
            "description": "`pdf` returns the searchable PDF. `txt` returns a plain text file of every page in reading order, with a form feed between pages."
          },
          "PageRange": {
            "type": "string",
            "description": "Pages to read. The other pages stay in the result unchanged, and with `OutputType=txt` the text they already had is still exported. A page past the end returns 400 (\"PageRange asks for page 3, but the document has 2 pages\"), but a range may end past it, so `1-2000` reads every page. With the open password of a file that keeps restrictions, `PageRange` returns 400 for now; send the owner password instead, or remove the password with `/v2/convert/pdf/to/unprotect` first. An open password that allows everything works with a range.\n\nValues: Pages and ranges, e.g. `1-3,8`, `5-` or `2-last`."
          },
          "Password": {
            "type": "string",
            "description": "Password of an encrypted PDF. With the open password of a file that allows changes but restricts something else, such as printing, the searchable result is saved with the same encryption, so it opens with the same password. When the open password allows everything, as on a file locked with only `UserPassword`, the result comes back with no password. With the owner password, the result comes back with no password and no restrictions, and so does a file locked only with an owner password that allows everything, whatever `Password` holds. A file that restricts editing needs its owner password; the open password alone returns 422."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the output file. The last extension is swapped for the real one: `scan.ocr.pdf` stays `scan.ocr.pdf`, and becomes `scan.ocr.txt` with `OutputType=txt`. Without it the result has the same name as the upload, so saving it next to the original overwrites the scan."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a download link instead of the file. The link expires after 3 hours and the file is then deleted."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `pdf/to/ocr`, `png/to/txt`, `jpg/to/txt`, `tiff/to/txt`: the parameters listed on https://pdfconversionapi.com/pdf/ocr. Other parameters are sent as text."
      },
      "PdfToDocxForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "PageRange": {
            "type": "string",
            "description": "Convert only these pages. We cut them out of the PDF before it is converted, so the DOCX holds nothing else. `last` stands for the final page. A page past the end returns 400 and says how many pages the file has; a range that runs past the end, such as `2-9`, stops at the last page. Left out, every page is converted.\n\nValues: Pages and ranges such as `1-3,5`, `4-` or `4-last` (to the end)."
          },
          "Password": {
            "type": "string",
            "description": "Opens an encrypted PDF. If the PDF forbids copying text, only the owner password works, and PDFs that open freely but forbid copying need it too. A missing or wrong password returns 422. `PageRange` works with the owner password, and with the open password of a file that restricts nothing; with the open password of a file that keeps restrictions it returns 400 for now (see the FAQ)."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the DOCX, without the extension. Left out, the DOCX keeps the stem of the uploaded PDF's name."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a download link instead of the file in the response. The link stops working after 3 hours."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `pdf/to/docx`: the parameters listed on https://pdfconversionapi.com/convert/pdf-to-docx. Other parameters are sent as text."
      },
      "PdfToJpgForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "ImageResolution": {
            "type": "integer",
            "minimum": 36,
            "maximum": 600,
            "default": 150,
            "description": "Dots per inch to draw each page at. Width in pixels is the page width in inches times this number, so a US Letter page at 72 gives 612 × 792. When you send it, the JPEG header records that DPI; left out, it records none. ConvertAPI's default is 200; send `ImageResolution=200` if your code relies on that size."
          },
          "ImageQuality": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 85,
            "description": "JPEG quality. Lower numbers give smaller files and more visible blocks around text. ConvertAPI's default is 75."
          },
          "ImageWidth": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20000,
            "description": "Width of each page image in pixels; the height keeps the page's proportions. `ImageWidth=400` gave a 400 × 518 first page. The page is drawn at that size rather than shrunk from a 150 DPI image."
          },
          "ImageHeight": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20000,
            "description": "Height in pixels, the width following: `ImageHeight=400` gave 309 × 400 pages. With `ImageWidth` too, each page fits inside both, so 400 × 400 also gave 309 × 400."
          },
          "ScaleProportions": {
            "type": "boolean",
            "default": true,
            "description": "With `false` and both sizes set, pages are stretched to exactly that box: 400 × 400 gave a square image of the tall Letter page."
          },
          "ScaleIfLarger": {
            "type": "boolean",
            "default": false,
            "description": "With `true`, a size only shrinks pages; a page already smaller than the size at `ImageResolution` keeps that size."
          },
          "ScaleImage": {
            "type": "boolean",
            "default": true,
            "description": "With `false`, the page is drawn at `ImageResolution` and cut to `ImageWidth` × `ImageHeight` from its top left corner instead of scaled."
          },
          "ColorSpace": {
            "type": "string",
            "enum": ["rgb", "gray", "monochrome"],
            "default": "rgb",
            "description": "`gray` writes a one-channel grayscale JPEG: the sample's first page went from 197,743 to 142,535 bytes. `monochrome` makes every pixel black or white before encoding (147,314 bytes); JPEG compression then leaves some pixels a little off pure black and white, so use PNG where you need exactly two values. `cmyk` returns 400."
          },
          "PageRange": {
            "type": "string",
            "description": "Only draw these pages. Left out, every page is drawn. `last` stands for the final page. A page past the end of the file returns 400 with the page count in the message; a range that runs past the end, such as `2-5`, stops at the last page.\n\nValues: Pages and ranges such as `1-3,5`, `10-` or `10-last` (to the end)."
          },
          "BackgroundColor": {
            "type": "string",
            "default": "white",
            "description": "Color painted behind each page before it is drawn. It shows wherever the PDF leaves the page unpainted; pictures, shaded cells and pages that fill their own background keep their colors. Text is not recolored, so dark text on a dark color becomes hard to read. A value that is not a color returns 400.\n\nValues: `white`, `black`, `red`, `green`, `blue`, `gray`, `#RRGGBB` or `R,G,B`."
          },
          "Password": {
            "type": "string",
            "description": "Opens a PDF that needs a password to open; the open password and the owner password both work. Sent with a PDF that opens without one, it changes nothing."
          },
          "FileName": {
            "type": "string",
            "description": "Stem for the output names, which become <`FileName`>-1.jpg, <`FileName`>-2.jpg and so on. Without it the uploaded file's name is used."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a download link for each page instead of the image data. Every page gets its own link, valid for 3 hours."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `pdf/to/jpg`: the parameters listed on https://pdfconversionapi.com/convert/pdf-to-jpg. Other parameters are sent as text."
      },
      "PdfToMdForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "PageRange": {
            "type": "string",
            "description": "Convert only these pages. They are cut out of the PDF before the Markdown is built. `last` stands for the final page. A page past the end returns 400 with the page count; page 0 and a reversed range return 400 too.\n\nValues: Pages and ranges such as `1-2,6`, `3-` or `3-last` (to the end)."
          },
          "Password": {
            "type": "string",
            "description": "The password of an encrypted PDF. A PDF that forbids copying text, even one that opens without a password, needs its owner password. With `PageRange`, the open password works only on a file that restricts nothing; on a file that keeps restrictions it returns 400 for now, so send the owner password or remove the protection with `/v2/convert/pdf/to/unprotect` first."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the .md file without its extension; otherwise the PDF's name is reused."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Get a download link for the Markdown instead of the file itself. Links last 3 hours."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `pdf/to/md`: the parameters listed on https://pdfconversionapi.com/convert/pdf-to-md. Other parameters are sent as text."
      },
      "PdfToPngForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "ImageResolution": {
            "type": "integer",
            "minimum": 36,
            "maximum": 600,
            "default": 150,
            "description": "How many pixels to draw per inch of page. Our 11 × 8.5 inch sample is 1,650 × 1,275 at the default and 3,300 × 2,550 at 300. When you send it, the PNG also records that DPI; left out, no DPI is written. ConvertAPI uses 200 when this is left out, so set it explicitly if you are moving code over."
          },
          "ImageWidth": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20000,
            "description": "Width of each page image in pixels, with the height following the page's proportions: `ImageWidth=800` gave 800 × 618 pages from the sample. The page is drawn at that scale, not shrunk from a larger render. A page that would be drawn past 16,000 pixels on a side returns 413."
          },
          "ImageHeight": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20000,
            "description": "Height in pixels, the width following: `ImageHeight=600` gave 776 × 600. With both sizes set, the page fits inside the box, so 800 × 800 gave 800 × 618."
          },
          "ScaleProportions": {
            "type": "boolean",
            "default": true,
            "description": "With `false` and both sizes set, each page is stretched to exactly that box: 800 × 800 gave square images of the sample's wide sheets."
          },
          "ScaleIfLarger": {
            "type": "boolean",
            "default": false,
            "description": "With `true`, a size only ever makes a page smaller. `ImageWidth=2000` then returned the sample at its 150 DPI size, 1,650 × 1,275, because the page is already narrower than that."
          },
          "ScaleImage": {
            "type": "boolean",
            "default": true,
            "description": "With `false`, the page is drawn at `ImageResolution` and cut to the size instead of scaled: `ImageWidth=800` gave the left 800 × 1,275 pixels of each sheet."
          },
          "ColorSpace": {
            "type": "string",
            "enum": ["rgb", "gray", "monochrome"],
            "default": "rgb",
            "description": "`rgb`, the default, writes three-channel PNGs with no alpha channel: the sample's page 1 is a 168,876-byte RGB PNG. `gray` writes one-channel grayscale (63,392 bytes for page 1), and `monochrome` turns every pixel pure black or white (25,359 bytes). Sent with `TransparentColor`, `rgb` gives an RGBA PNG and `gray` a grayscale PNG with alpha. `cmyk` returns 400."
          },
          "PageRange": {
            "type": "string",
            "description": "Draw only these pages; the rest are skipped. `last` stands for the final page. A page past the end returns 400 with the page count, and a reversed range such as 2-1 returns 400.\n\nValues: Pages and ranges such as `2`, `1-4`, `3-` or `3-last` (to the end)."
          },
          "TransparentColor": {
            "type": "string",
            "description": "Every pixel of exactly this color becomes fully transparent. `TransparentColor=white` removes the page background. Near-white pixels, such as the soft edges of letters, stay as they are.\n\nValues: `white`, `black`, `red`, `green`, `blue`, `gray`, `#RRGGBB` or `R,G,B`."
          },
          "BackgroundColor": {
            "type": "string",
            "default": "white",
            "description": "Color painted behind each page; it only shows where the PDF paints nothing. A value that is not a color returns 400.\n\nValues: `white`, `black`, `red`, `green`, `blue`, `gray`, `#RRGGBB` or `R,G,B`."
          },
          "Password": {
            "type": "string",
            "description": "Opens a PDF that needs a password to open; the open password and the owner password both work. Our protected one-page statement gave the same PNG with either. Sent with a PDF that opens without one, it changes nothing."
          },
          "FileName": {
            "type": "string",
            "description": "Stem for the page files: `FileName=g2-wiring` gives `g2-wiring-1.png`, `g2-wiring-2.png`. Without it, the stem of the uploaded PDF is used."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Store the PNGs and return one download link per page in place of the data. Links expire after 3 hours."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `pdf/to/png`: the parameters listed on https://pdfconversionapi.com/convert/pdf-to-png. Other parameters are sent as text."
      },
      "PdfToTxtForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "Password": {
            "type": "string",
            "description": "Opens a PDF that needs a password to open. The open password is enough when the PDF allows copying text. When it forbids copying, send the owner password: it opens the file without its restrictions, while the open password keeps them and returns 422. A PDF that opens freely but forbids copying needs its owner password too; on one that allows copying, `Password` changes nothing."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the text file, without the extension. `FileName=minutes-2026-10-14` returns `minutes-2026-10-14.txt`; left out, the PDF's own name is reused."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Keep the .txt on our side and return a link to it instead of the content. The link is valid for 3 hours."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `pdf/to/txt`: the parameters listed on https://pdfconversionapi.com/convert/pdf-to-txt. Other parameters are sent as text."
      },
      "PdfaForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "PdfaVersion": {
            "type": "string",
            "enum": ["pdfA2b", "pdfA3b"],
            "default": "pdfA2b",
            "description": "On `/v2/convert/pdf/to/pdfa`, the PDF/A part to write: PDF/A-2b (ISO 19005-2) or PDF/A-3b (ISO 19005-3), which also allows attached files of any type. Matched in any case. Levels 1, A and U return 400."
          },
          "Password": {
            "type": "string",
            "description": "Opens an encrypted PDF. PDF/A does not allow encryption, so the output never has a password or copy and print restrictions. A file that restricts copying or printing needs its owner password here, whether or not it also has an open password: the open password alone returns 422. A file that restricts nothing, such as one locked by `pdf/to/protect` with both passwords and `AllowEverything=true`, converts with its open password. Locked with only an owner password and `AllowEverything=true`, it converts with no `Password` at all, and any value you send is ignored."
          },
          "ExpectedConformance": {
            "type": "string",
            "enum": ["auto", "pdfA2b", "pdfA3b"],
            "default": "auto",
            "description": "On `/v2/convert/pdfa/to/validate` only: the level to check against. `auto` uses the level the file claims in its XMP metadata, so a PDF/A-3b file is checked as 3b. A file that claims no level comes back with `compliant: false`, `level: null` and a single issue saying so; send `pdfA2b` to list every rule it breaks. A file that claims PDF/A-1, level A or U, or PDF/A-4 returns 422 with `auto`."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the output file. A final extension is dropped and .pdf (or .json on the validate route) is added, so `minutes.pdfa.pdf` stays `minutes.pdfa.pdf`. Without it the result takes the uploaded file's name."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a download link instead of the file. The link expires after 3 hours and the file is then deleted."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `pdf/to/pdfa`, `pdfa/to/validate`: the parameters listed on https://pdfconversionapi.com/pdf/pdfa. Other parameters are sent as text."
      },
      "PngToJpgForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "ImageQuality": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 85,
            "description": "JPEG quality. Left out, we encode at 85. Higher numbers keep more detail and make bigger files."
          },
          "AlphaColor": {
            "type": "string",
            "default": "white",
            "description": "The color that shows through wherever the PNG is transparent. Partly transparent pixels, such as soft shadows and anti-aliased edges, are mixed with it in proportion to their opacity.\n\nValues: `white`, `black`, `red`, `green`, `blue`, `gray`, `#RRGGBB` or `R,G,B`."
          },
          "BackgroundColor": {
            "type": "string",
            "default": "white",
            "description": "Another name for the fill color. It is used only when `AlphaColor` is not sent; if both are sent, `AlphaColor` wins.\n\nValues: Same as `AlphaColor`."
          },
          "ImageWidth": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20000,
            "description": "Target width in pixels. Sent alone, the height is calculated from the original aspect ratio. Resampling uses a Lanczos3 filter."
          },
          "ImageHeight": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20000,
            "description": "Target height in pixels. Sent alone, the width follows the aspect ratio. Sent with `ImageWidth`, the two form a box the image is fitted into."
          },
          "ScaleProportions": {
            "type": "boolean",
            "default": true,
            "description": "With both `ImageWidth` and `ImageHeight` set, `false` stretches the image to exactly that size instead of fitting it inside. It only matters when a width or height is sent; on its own it is accepted and changes nothing."
          },
          "ScaleIfLarger": {
            "type": "boolean",
            "default": false,
            "description": "Set to `true` to only ever shrink: when the requested size is bigger than the PNG, the original size is kept. Like `ScaleProportions`, it does nothing unless `ImageWidth` or `ImageHeight` is in the same request."
          },
          "ScaleImage": {
            "type": "boolean",
            "default": true,
            "description": "Set to `false` to crop instead of resize: the output keeps the top-left `ImageWidth` × `ImageHeight` pixels of the original. Without `ImageWidth` or `ImageHeight` there is nothing to crop, and the PNG keeps its size."
          },
          "ColorSpace": {
            "type": "string",
            "enum": ["rgb", "gray", "monochrome"],
            "default": "rgb",
            "description": "`gray` writes a one-channel grayscale JPEG; the mug sample went from 85,441 to 53,149 bytes at the default quality. `monochrome` turns each pixel black or white before encoding (56,879 bytes), and the JPEG compression leaves some edge pixels in between. Transparent areas are filled with `AlphaColor` first. `cmyk` returns 400."
          },
          "ImageResolution": {
            "type": "integer",
            "minimum": 10,
            "maximum": 800,
            "description": "The DPI written into the JPEG header, for print layouts and image editors. The pixels are not changed: the 1200 × 1200 sample stays 1200 × 1200 at 300. Left out, the header has no unit (density 1:1), not ConvertAPI's 200."
          },
          "ImageInterpolation": {
            "type": "boolean",
            "default": false,
            "description": "Accepted with `true` or `false`. Every resize already uses a Lanczos3 filter, so both values give the same file; other values return 400."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the JPEG, without the extension. Without it, the output is named after the uploaded PNG."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return `Files[].Url`, a download link, in place of the base64 data. Links stop working after 3 hours."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `png/to/jpg`: the parameters listed on https://pdfconversionapi.com/convert/png-to-jpg. Other parameters are sent as text."
      },
      "PngToPdfForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "PageSize": {
            "type": "string",
            "enum": ["default", "auto", "a3", "a4", "a5", "letter", "legal"],
            "default": "default",
            "description": "Sheet to place the PNG on. Left out, or set to `default` or `auto`, the page is exactly as big as the image at 96 pixels per inch. A named sheet shrinks a larger image to fit and centers it; a smaller image keeps its size."
          },
          "PageOrientation": {
            "type": "string",
            "enum": ["default", "portrait", "landscape"],
            "default": "default",
            "description": "Turns the named sheet on its side, swapping its width and height (Letter becomes 11 x 8.5 in), for wide images such as diagrams and screenshots. The values `default` and `portrait` leave the sheet upright. Ignored when the page takes the image's size."
          },
          "Rotate": {
            "type": "integer",
            "minimum": -360,
            "maximum": 360,
            "description": "Degrees to turn the image clockwise on its page. When the page takes the image's size, a quarter turn swaps its sides: 90 made the sample's 1,350 × 900 pt page 900 × 1,350. Other angles work too; 45 gave a 1,591 pt square page around the turned map. On a named sheet the turned image is fitted to the sheet. Left out, a PNG that carries an EXIF orientation is turned the way it says; send 0 to keep the stored layout."
          },
          "MarginHorizontal": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 0,
            "description": "White space left and right of the image, in millimeters. On the image's own page size the page grows by twice the margin: 10 made the sample page 1,406.69 pt wide instead of 1,350. On a named sheet the image is shrunk to fit inside the margins.\n\nValues: 0–500 (mm)."
          },
          "MarginVertical": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 0,
            "description": "White space above and below the image, in millimeters, working the same way. On the sample's Letter landscape sheet, 15 mm on all four sides drew the map 707 × 471 pt instead of the full 792 pt width.\n\nValues: 0–500 (mm)."
          },
          "FileName": {
            "type": "string",
            "description": "Output file name without .pdf. By default the PDF is named after the uploaded PNG."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Keep the PDF on our side for 3 hours and return a download URL in place of the base64 data. The file is deleted when the link expires."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `png/to/pdf`: the parameters listed on https://pdfconversionapi.com/convert/png-to-pdf. Other parameters are sent as text."
      },
      "PptxToPdfForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "ConvertHiddenSlides": {
            "type": "boolean",
            "default": false,
            "description": "With `true`, slides marked hidden get a page too. Our 7-slide sample has slide 6 hidden: the default gives 6 pages, and `true` gives 7, with a \"6. Backup: operating cost estimate (hidden slide)\" bookmark between 5 and 7."
          },
          "Password": {
            "type": "string",
            "description": "Opens a deck protected with a password to open, as PowerPoint 2010 and later save it. A copy of the sample locked that way gave the same PDF as the unprotected file. Decks using Office 2007's older encryption return 422. Sent with a deck that has no password, it changes nothing."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the PDF, without the extension. Left out, the PDF is named after the uploaded deck, so `route-14-meeting.pptx` comes back as `route-14-meeting.pdf`."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a download URL in `Files[0].Url` instead of base64 data. The URL stops working after 3 hours and the stored PDF is deleted."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `pptx/to/pdf`, `ppt/to/pdf`: the parameters listed on https://pdfconversionapi.com/convert/pptx-to-pdf. Other parameters are sent as text."
      },
      "ProtectForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "UserPassword": {
            "type": "string",
            "description": "Password needed to open the file. On its own it restricts nothing: whoever has it can print, copy and edit. Send `UserPassword`, `OwnerPassword` or both; with neither the API returns 400."
          },
          "OwnerPassword": {
            "type": "string",
            "description": "Password needed to change or remove the security. With it, the restrictions apply: each permission below is off unless you set it to `true`. Without a `UserPassword` the file opens with no prompt and only the restrictions apply."
          },
          "EncryptionAlgorithm": {
            "type": "string",
            "enum": ["Aes256Bit", "Aes128Bit", "Standard128Bit", "Standard40Bit"],
            "default": "Aes256Bit",
            "description": "`Aes256Bit` writes AES-256 (security handler revision 6). `Aes128Bit` is revision 4. `Standard128Bit` and `Standard40Bit` are the old RC4 schemes (revisions 3 and 2), only for readers that predate AES."
          },
          "EncryptMeta": {
            "type": "boolean",
            "default": false,
            "description": "Also encrypt the XMP metadata stream. Left off, the XMP metadata stays readable without the password, so file indexers can still see it."
          },
          "PrintDocument": {
            "type": "boolean",
            "default": false,
            "description": "Needs `OwnerPassword`. Allow printing at low resolution."
          },
          "PrintFaithfulCopy": {
            "type": "boolean",
            "default": false,
            "description": "Needs `OwnerPassword`. Allow printing at full quality. Low-resolution printing is included, so `PrintDocument` adds nothing when sent with it."
          },
          "CopyContents": {
            "type": "boolean",
            "default": false,
            "description": "Needs `OwnerPassword`. Allow copying text and images. `ExtractContents` does the same; sending both is fine."
          },
          "ExtractContents": {"type": "boolean", "default": false, "description": "Same effect as `CopyContents`."},
          "FillFormFields": {
            "type": "boolean",
            "default": false,
            "description": "Needs `OwnerPassword`. Allow filling in form fields and signing."
          },
          "ModifyAnnotations": {
            "type": "boolean",
            "default": false,
            "description": "Needs `OwnerPassword`. Allow comments, plus filling in forms and signing."
          },
          "AssembleDocument": {
            "type": "boolean",
            "default": false,
            "description": "Needs `OwnerPassword`. Allow inserting, deleting and rotating pages, and nothing else in the changes group. Sent with `ModifyContents`, `ModifyAnnotations`, `FillFormFields` or `AllowEverything`, it is accepted but has no effect: the other flag decides, and page assembly stays off."
          },
          "ModifyContents": {
            "type": "boolean",
            "default": false,
            "description": "Needs `OwnerPassword`. Allow editing the document, comments and forms. Page assembly stays off."
          },
          "AllowEverything": {
            "type": "boolean",
            "default": false,
            "description": "Needs `OwnerPassword`. Turn on printing, copying, editing, comments and forms in one switch. Page assembly stays off today, even if you add `AssembleDocument`; other flags sent with it change nothing."
          },
          "Password": {
            "type": "string",
            "description": "For an input that is already protected: its owner password. The old security is replaced by the new one. The user password is enough only on a file that restricts nothing, such as one this route locked with only a `UserPassword`, or with both passwords and `AllowEverything=true`; on a file with restrictions it returns 422. A file that opens without a password and restricts nothing needs no `Password`."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the output file; the last extension is replaced with .pdf. Without it the result has the same name as the upload, and saving it next to the original overwrites the unprotected file."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a download link instead of the file. The link expires after 3 hours and the file is then deleted."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `pdf/to/protect`: the parameters listed on https://pdfconversionapi.com/pdf/protect. Other parameters are sent as text."
      },
      "RotateForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "Angle": {
            "type": "integer",
            "default": 90,
            "description": "Degrees to turn each selected page; positive values turn it clockwise as a viewer shows it. The angle is added to any rotation the page already has, so 90 on a page set to 270 brings it to 0.\n\nValues: -270, -180, -90, 0, 90, 180, 270."
          },
          "PageRange": {
            "type": "string",
            "description": "Pages to turn. Every page is turned when it is left out. Ranges are 1-based; an open end such as 3- or 3-last runs to the last page. A range that ends past the last page stops there, but a page or range start past it returns 400 and nothing is turned.\n\nValues: for example `1`, `2-4,7`, `3-` or `2-last`."
          },
          "Password": {
            "type": "string",
            "description": "Opens a PDF that needs a password to open; the rotated file comes back with no password. The open password is enough when the file restricts nothing, which includes a file locked by `pdf/to/protect` with `AllowEverything=true`. When it restricts printing, copying or editing, send the owner password; the open password then returns 422 \"this PDF has permission restrictions\". On a PDF that opens without a password, the owner password lifts its restrictions and any other value changes nothing."
          },
          "FileName": {
            "type": "string",
            "description": "Output name without the extension. Leave it out and the rotated file keeps the uploaded file's name."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Get `Files[].Url`, a link to download the rotated PDF, in place of the base64 data. The link lasts 3 hours."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `pdf/to/rotate`: the parameters listed on https://pdfconversionapi.com/pdf/rotate. Other parameters are sent as text."
      },
      "SplitForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "SplitByPages": {
            "type": "integer",
            "minimum": 1,
            "maximum": 10000,
            "default": 1,
            "description": "Pages per output file. The last file holds whatever is left over: our 6-page sample with `SplitByPages=4` came back as a 4-page file and a 2-page file."
          },
          "PageRange": {
            "type": "string",
            "description": "Split only these pages; without it every page is used. The list is sorted and each page used once, so 2,1,2 means pages 1 and 2. An open end such as 4- or 4-last runs to the last page, and last on its own is the last page. A range that ends past the last page stops there, but a page or range start past it returns 400, for example \"PageRange asks for page 9, but the document has 6 pages\".\n\nValues: for example `1-3,5`, `4-` or `2-last`."
          },
          "Password": {
            "type": "string",
            "description": "Opens a PDF that needs a password to open, and the parts come back with no password. The open password is enough when the file restricts nothing; a file from `pdf/to/protect` with `AllowEverything=true` counts as unrestricted, since editing includes page assembly. When it also restricts printing, copying or editing, send the owner password; the open password then returns 422 \"this PDF has permission restrictions\". On a PDF that opens without a password, only the owner password does anything: it lifts the restrictions."
          },
          "FileName": {
            "type": "string",
            "description": "Base name for the parts. `FileName=statement` returns `statement-1.pdf`, `statement-2.pdf` and so on; without it the parts take the uploaded file's name."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a separate download URL for each part (`Files[].Url`) and no file data. Each link expires 3 hours after the request."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `pdf/to/split`: the parameters listed on https://pdfconversionapi.com/pdf/split. Other parameters are sent as text."
      },
      "SvgToPdfForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "PageSize": {
            "type": "string",
            "description": "Paper size. A4 is the default because it is ConvertAPI's, so US code should send `letter`. The drawing is scaled up or down to fit the page and never cropped.\n\nValues: `a0`–`a9`, `b0`–`b5`, `letter`, `legal`, `ledger`.\n\nDefault: a4."
          },
          "PageOrientation": {
            "type": "string",
            "enum": ["portrait", "landscape", "default"],
            "default": "portrait",
            "description": "The second value turns the page sideways by swapping its width and height, custom sizes included. `default` is accepted and keeps the page upright, like portrait. The sample uses the sideways setting to put an 1100 × 850 drawing on an 11 × 8.5 inch page."
          },
          "PageWidth": {
            "type": "integer",
            "minimum": 10,
            "maximum": 30000,
            "description": "Custom page width in whole millimeters. It replaces the width of `PageSize`, so you can send it alone or with `PageHeight`.\n\nValues: 10–30000 (mm)."
          },
          "PageHeight": {
            "type": "integer",
            "minimum": 10,
            "maximum": 30000,
            "description": "Custom page height in whole millimeters, replacing the height of `PageSize`.\n\nValues: 10–30000 (mm)."
          },
          "HorizontalAlignment": {
            "type": "string",
            "enum": ["left", "center", "right"],
            "default": "center",
            "description": "Where the drawing sits when the page is relatively wider than the SVG, so there is spare room left and right."
          },
          "VerticalAlignment": {
            "type": "string",
            "enum": ["top", "center", "bottom"],
            "default": "center",
            "description": "Where the drawing sits when there is spare room above and below it, such as a wide SVG on a portrait page."
          },
          "BackgroundColor": {
            "type": "string",
            "default": "White",
            "description": "Fills the whole page before the SVG is drawn. transparent paints nothing, so the page has no background object at all.\n\nValues: `transparent`, `white`, `black`, `red`, `green`, `blue`, `gray`, `#RRGGBB` or `R,G,B`."
          },
          "UseImagePageSize": {
            "type": "boolean",
            "default": false,
            "description": "`true` makes the page exactly the SVG's size, at 0.75 pt per SVG pixel (1100 × 850 becomes 825 × 637.5 pt). `PageSize`, `PageOrientation`, `PageWidth` and `PageHeight` are then not read, and sending one of them with a non-default value returns 400."
          },
          "FileName": {
            "type": "string",
            "description": "Name of the PDF without .pdf. If omitted, `floor-plan.svg` becomes `floor-plan.pdf`."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Keeps the PDF for 3 hours and returns its download URL instead of the file content."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `svg/to/pdf`: the parameters listed on https://pdfconversionapi.com/convert/svg-to-pdf. Other parameters are sent as text."
      },
      "SvgToPngForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "ImageWidth": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20000,
            "description": "Width of the PNG in pixels. The height is derived from the drawing's aspect ratio. Without a size, one SVG user unit becomes one pixel (the sample is 600 × 315)."
          },
          "ImageHeight": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20000,
            "description": "Height in pixels, with the width derived. Send both and the drawing is fitted inside that box without distortion: 1000 × 1000 gave 1000 × 525 for the sample."
          },
          "ScaleProportions": {
            "type": "boolean",
            "default": true,
            "description": "With `false` and both sizes set, the drawing is stretched to exactly that box: 1000 × 1000 gave a square PNG of the wide card."
          },
          "ScaleIfLarger": {
            "type": "boolean",
            "default": false,
            "description": "With `true`, a size only ever shrinks the drawing: `ImageWidth=1200` then returned the card at its own 600 × 315, while 300 still gave 300 × 158."
          },
          "ScaleImage": {
            "type": "boolean",
            "default": true,
            "description": "With `false`, the SVG is drawn at its own size and cut to the size you send from the top left corner: `ImageWidth=300` gave the left 300 × 315 pixels of the card."
          },
          "ImageResolution": {
            "type": "integer",
            "minimum": 10,
            "maximum": 800,
            "description": "The DPI written into the PNG, for layout and print tools. It doesn't change the pixel size: SVG lengths are read as CSS pixels, 96 per inch, so width=\"210mm\" becomes 794 px whatever you send. Choose the size with `ImageWidth` or `ImageHeight`. Left out, the PNG carries no DPI."
          },
          "ImageInterpolation": {
            "type": "boolean",
            "default": false,
            "description": "Accepted with `true` or `false`. The drawing is rendered at the target size rather than resampled, so both values give the same file."
          },
          "ColorSpace": {
            "type": "string",
            "enum": ["rgb", "gray", "monochrome"],
            "description": "`gray` writes a grayscale PNG (one channel, plus alpha where the SVG leaves pixels transparent): the card at 600 × 315 went from 61,859 to 22,190 bytes. `monochrome` turns each pixel black or white (4,902 bytes). `rgb` drops the alpha channel when no pixel uses it: the card paints its whole canvas and came back as a 58,476-byte RGB PNG, while an SVG with transparent areas stays RGBA. `cmyk` returns 400."
          },
          "TransparentColor": {
            "type": "string",
            "description": "Every pixel of exactly this color is made fully transparent after rendering. Anti-aliased edge pixels are mixtures, so they keep a faint fringe of the original color.\n\nValues: `white`, `black`, `red`, `green`, `blue`, `gray`, `#RRGGBB` or `R,G,B`."
          },
          "FileName": {
            "type": "string",
            "description": "Output name without the extension; `blog-card.svg` gives `blog-card.png` when this is not set."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "With `true`, the response holds a link (`Files[].Url`) to the PNG instead of its bytes. The link is valid for 3 hours."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `svg/to/png`: the parameters listed on https://pdfconversionapi.com/convert/svg-to-png. Other parameters are sent as text."
      },
      "UnlockForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "Password": {
            "type": "string",
            "description": "The file's owner password. The user password, the one asked for when the file opens, is enough only if the file has no restrictions, for example one protected with a `UserPassword` and no `OwnerPassword`, or one locked by `pdf/to/protect` with `AllowEverything=true`. A file that opens without a password and restricts nothing, such as one locked with only an `OwnerPassword` and `AllowEverything=true`, needs no `Password`: sent without one, or with a wrong one, it comes back unencrypted."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the output file; the last extension is replaced with .pdf. Without it the result has the same name as the upload."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a download link instead of the file. The link expires after 3 hours and the file is then deleted."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `pdf/to/unprotect`: the parameters listed on https://pdfconversionapi.com/pdf/unlock. Other parameters are sent as text."
      },
      "PdfToTextWatermarkForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "Text": {
            "type": "string",
            "description": "`text-watermark` only, required. A line break in the value starts a second line. Western European characters only; other scripts return 422."
          },
          "FontSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 1000,
            "description": "`text-watermark` only. Left out, the text is sized to run across the page.\n\nValues: 1–1000 (points).\n\nDefault: fit to page."
          },
          "FontColor": {
            "type": "string",
            "default": "#999999",
            "description": "`text-watermark` only. A name (`white`, `black`, `red`, `green`, `blue`, `gray`), `#RRGGBB` or `R,G,B`."
          },
          "Opacity": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100,
            "default": 50,
            "description": "How opaque the mark is, in percent. All three routes."
          },
          "Rotate": {
            "type": "integer",
            "minimum": -360,
            "maximum": 360,
            "default": 45,
            "description": "Angle in degrees, counter-clockwise; negative turns clockwise. Left out, the mark runs diagonally from bottom left to top right. All three routes; send 0 for a level mark."
          },
          "Style": {
            "type": "string",
            "enum": ["stamp", "watermark"],
            "default": "stamp",
            "description": "`stamp` draws the mark over the page content. `watermark` draws it underneath, so shaded table cells and filled shapes cover those parts of it. All three routes."
          },
          "OffsetX": {
            "type": "number",
            "default": 0,
            "description": "Move the mark right from the page center, in `MeasurementUnit`. Negative moves it left."
          },
          "OffsetY": {
            "type": "number",
            "default": 0,
            "description": "Move the mark down from the page center. Negative moves it up."
          },
          "MeasurementUnit": {
            "type": "string",
            "enum": ["pt", "in", "mm", "cm"],
            "default": "pt",
            "description": "Unit for `OffsetX` and `OffsetY`."
          },
          "PageRange": {
            "type": "string",
            "description": "Pages to mark. Left out, every page gets the mark. A page past the end returns 400 (\"PageRange asks for page 3, but the document has 2 pages\"), but a range may end past it. On a protected file, `PageRange` works with the owner password, and with the open password of a file that restricts nothing; with the open password of a file that keeps restrictions it returns 400 for now.\n\nValues: Pages and ranges, e.g. `1`, `2-5,9` or `2-last`."
          },
          "OverlayPage": {
            "type": "integer",
            "default": 1,
            "description": "`pdf-watermark` only. Which page of `OverlayFile` to use. A page past the end returns 422."
          },
          "Scale": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 50,
            "description": "`image-watermark` and `pdf-watermark`. Size of the mark relative to the page, in percent. Values up to 1000 are accepted, but anything over 100 is drawn at 100."
          },
          "Password": {
            "type": "string",
            "description": "Password of an encrypted input. Opened with its owner password, or with the open password of a file that restricts nothing, the result comes back unencrypted; opened with the open password of a file that keeps restrictions, it keeps the same encryption and password. A file that restricts editing needs its owner password, even if it opens without one; the open password alone returns 422. A file with only an owner password that restricts nothing needs no `Password` and comes back unencrypted, whatever you send."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the output file; the last extension is replaced with .pdf. Without it the result has the same name as the upload, so saving it next to the original replaces the unmarked file."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a download link instead of the file. The link expires after 3 hours and the file is then deleted."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `pdf/to/text-watermark`: the parameters listed on https://pdfconversionapi.com/pdf/watermark. Other parameters are sent as text."
      },
      "PdfToImageWatermarkForm": {
        "type": "object",
        "required": ["File", "ImageFile"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "Text": {
            "type": "string",
            "description": "`text-watermark` only, required. A line break in the value starts a second line. Western European characters only; other scripts return 422."
          },
          "FontSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 1000,
            "description": "`text-watermark` only. Left out, the text is sized to run across the page.\n\nValues: 1–1000 (points).\n\nDefault: fit to page."
          },
          "FontColor": {
            "type": "string",
            "default": "#999999",
            "description": "`text-watermark` only. A name (`white`, `black`, `red`, `green`, `blue`, `gray`), `#RRGGBB` or `R,G,B`."
          },
          "Opacity": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100,
            "default": 50,
            "description": "How opaque the mark is, in percent. All three routes."
          },
          "Rotate": {
            "type": "integer",
            "minimum": -360,
            "maximum": 360,
            "default": 45,
            "description": "Angle in degrees, counter-clockwise; negative turns clockwise. Left out, the mark runs diagonally from bottom left to top right. All three routes; send 0 for a level mark."
          },
          "Style": {
            "type": "string",
            "enum": ["stamp", "watermark"],
            "default": "stamp",
            "description": "`stamp` draws the mark over the page content. `watermark` draws it underneath, so shaded table cells and filled shapes cover those parts of it. All three routes."
          },
          "OffsetX": {
            "type": "number",
            "default": 0,
            "description": "Move the mark right from the page center, in `MeasurementUnit`. Negative moves it left."
          },
          "OffsetY": {
            "type": "number",
            "default": 0,
            "description": "Move the mark down from the page center. Negative moves it up."
          },
          "MeasurementUnit": {
            "type": "string",
            "enum": ["pt", "in", "mm", "cm"],
            "default": "pt",
            "description": "Unit for `OffsetX` and `OffsetY`."
          },
          "PageRange": {
            "type": "string",
            "description": "Pages to mark. Left out, every page gets the mark. A page past the end returns 400 (\"PageRange asks for page 3, but the document has 2 pages\"), but a range may end past it. On a protected file, `PageRange` works with the owner password, and with the open password of a file that restricts nothing; with the open password of a file that keeps restrictions it returns 400 for now.\n\nValues: Pages and ranges, e.g. `1`, `2-5,9` or `2-last`."
          },
          "ImageFile": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "`image-watermark` only, required. Sent as a second file field. PNG transparency is kept, and the image is embedded at its own pixel size.\n\nValues: PNG, JPEG, TIFF, GIF, BMP."
          },
          "OverlayPage": {
            "type": "integer",
            "default": 1,
            "description": "`pdf-watermark` only. Which page of `OverlayFile` to use. A page past the end returns 422."
          },
          "Scale": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 50,
            "description": "`image-watermark` and `pdf-watermark`. Size of the mark relative to the page, in percent. Values up to 1000 are accepted, but anything over 100 is drawn at 100."
          },
          "Password": {
            "type": "string",
            "description": "Password of an encrypted input. Opened with its owner password, or with the open password of a file that restricts nothing, the result comes back unencrypted; opened with the open password of a file that keeps restrictions, it keeps the same encryption and password. A file that restricts editing needs its owner password, even if it opens without one; the open password alone returns 422. A file with only an owner password that restricts nothing needs no `Password` and comes back unencrypted, whatever you send."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the output file; the last extension is replaced with .pdf. Without it the result has the same name as the upload, so saving it next to the original replaces the unmarked file."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a download link instead of the file. The link expires after 3 hours and the file is then deleted."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `pdf/to/image-watermark`: the parameters listed on https://pdfconversionapi.com/pdf/watermark. Other parameters are sent as text."
      },
      "PdfToPdfWatermarkForm": {
        "type": "object",
        "required": ["File", "OverlayFile"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "Text": {
            "type": "string",
            "description": "`text-watermark` only, required. A line break in the value starts a second line. Western European characters only; other scripts return 422."
          },
          "FontSize": {
            "type": "integer",
            "minimum": 1,
            "maximum": 1000,
            "description": "`text-watermark` only. Left out, the text is sized to run across the page.\n\nValues: 1–1000 (points).\n\nDefault: fit to page."
          },
          "FontColor": {
            "type": "string",
            "default": "#999999",
            "description": "`text-watermark` only. A name (`white`, `black`, `red`, `green`, `blue`, `gray`), `#RRGGBB` or `R,G,B`."
          },
          "Opacity": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100,
            "default": 50,
            "description": "How opaque the mark is, in percent. All three routes."
          },
          "Rotate": {
            "type": "integer",
            "minimum": -360,
            "maximum": 360,
            "default": 45,
            "description": "Angle in degrees, counter-clockwise; negative turns clockwise. Left out, the mark runs diagonally from bottom left to top right. All three routes; send 0 for a level mark."
          },
          "Style": {
            "type": "string",
            "enum": ["stamp", "watermark"],
            "default": "stamp",
            "description": "`stamp` draws the mark over the page content. `watermark` draws it underneath, so shaded table cells and filled shapes cover those parts of it. All three routes."
          },
          "OffsetX": {
            "type": "number",
            "default": 0,
            "description": "Move the mark right from the page center, in `MeasurementUnit`. Negative moves it left."
          },
          "OffsetY": {
            "type": "number",
            "default": 0,
            "description": "Move the mark down from the page center. Negative moves it up."
          },
          "MeasurementUnit": {
            "type": "string",
            "enum": ["pt", "in", "mm", "cm"],
            "default": "pt",
            "description": "Unit for `OffsetX` and `OffsetY`."
          },
          "PageRange": {
            "type": "string",
            "description": "Pages to mark. Left out, every page gets the mark. A page past the end returns 400 (\"PageRange asks for page 3, but the document has 2 pages\"), but a range may end past it. On a protected file, `PageRange` works with the owner password, and with the open password of a file that restricts nothing; with the open password of a file that keeps restrictions it returns 400 for now.\n\nValues: Pages and ranges, e.g. `1`, `2-5,9` or `2-last`."
          },
          "OverlayFile": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "`pdf-watermark` only, required. A PDF whose page is placed on each page as the mark. Text and vector drawing in it stay vector."
          },
          "OverlayPage": {
            "type": "integer",
            "default": 1,
            "description": "`pdf-watermark` only. Which page of `OverlayFile` to use. A page past the end returns 422."
          },
          "Scale": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 50,
            "description": "`image-watermark` and `pdf-watermark`. Size of the mark relative to the page, in percent. Values up to 1000 are accepted, but anything over 100 is drawn at 100."
          },
          "Password": {
            "type": "string",
            "description": "Password of an encrypted input. Opened with its owner password, or with the open password of a file that restricts nothing, the result comes back unencrypted; opened with the open password of a file that keeps restrictions, it keeps the same encryption and password. A file that restricts editing needs its owner password, even if it opens without one; the open password alone returns 422. A file with only an owner password that restricts nothing needs no `Password` and comes back unencrypted, whatever you send."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the output file; the last extension is replaced with .pdf. Without it the result has the same name as the upload, so saving it next to the original replaces the unmarked file."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a download link instead of the file. The link expires after 3 hours and the file is then deleted."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `pdf/to/pdf-watermark`: the parameters listed on https://pdfconversionapi.com/pdf/watermark. Other parameters are sent as text."
      },
      "WebpToJpgForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "ImageQuality": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 85,
            "description": "Quality setting for the JPEG encoder. We use 85 if you don't send one; ConvertAPI's documented default is 75."
          },
          "ImageWidth": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20000,
            "description": "Output width in pixels. The sample sends 1200, so the 1600 × 900 banner comes back 1200 × 675."
          },
          "ImageHeight": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20000,
            "description": "Output height in pixels. On its own it sets the height and derives the width; together with `ImageWidth` it defines a maximum box."
          },
          "ScaleProportions": {
            "type": "boolean",
            "default": true,
            "description": "`false` lets the picture be distorted to fill the exact `ImageWidth` × `ImageHeight`. Sent without a width or height, it is accepted and changes nothing."
          },
          "ScaleIfLarger": {
            "type": "boolean",
            "default": false,
            "description": "`true` turns the resize into a downscale-only step, so a WebP narrower than `ImageWidth` keeps its own size. It has no effect unless a width or height is in the request."
          },
          "ScaleImage": {
            "type": "boolean",
            "default": true,
            "description": "`false` cuts a region out of the top-left corner at the requested width and height, with no scaling. Without a width or height, the WebP keeps its full size."
          },
          "AlphaColor": {
            "type": "string",
            "default": "white",
            "description": "Matte color for WebP files that carry an alpha channel. Opaque WebPs, like the sample, are not affected.\n\nValues: A color name (`white`, `black`, `red`, `green`, `blue`, `gray`), `#RRGGBB` or `R,G,B`."
          },
          "BackgroundColor": {
            "type": "string",
            "default": "white",
            "description": "Read as the matte color when `AlphaColor` is absent.\n\nValues: Same as `AlphaColor`."
          },
          "ColorSpace": {
            "type": "string",
            "enum": ["rgb", "gray", "monochrome"],
            "default": "rgb",
            "description": "`gray` writes a one-channel grayscale JPEG: the full-size banner went from 122,718 to 79,969 bytes at the default quality. `monochrome` turns each pixel black or white before the JPEG encode (84,934 bytes). `cmyk` returns 400."
          },
          "ImageResolution": {
            "type": "integer",
            "minimum": 10,
            "maximum": 800,
            "description": "The DPI recorded in the JPEG header. Pixels are not resampled: the banner stays 1600 × 900 at 72 or 200. Left out, the header has no unit (density 1:1); ConvertAPI documents 200."
          },
          "ImageInterpolation": {
            "type": "boolean",
            "default": false,
            "description": "Accepted with `true` or `false`. Resizing always uses a Lanczos3 filter, so the sample request gave the same 73,060 bytes either way."
          },
          "FileName": {
            "type": "string",
            "description": "Base name for the result. `spring-tuneup-banner.webp` becomes `spring-tuneup-banner.jpg` unless you set this."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "`true` keeps the JPEG on our side for 3 hours and returns a download URL in `Files[].Url` instead of `FileData`."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `webp/to/jpg`: the parameters listed on https://pdfconversionapi.com/convert/webp-to-jpg. Other parameters are sent as text."
      },
      "XlsxToCsvForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "WorksheetName": {
            "type": "string",
            "description": "Export the tab with this name; upper and lower case are treated alike. A name the workbook doesn't have returns 400 \"no worksheet named 'Inventory'\"."
          },
          "WorksheetIndex": {
            "type": "integer",
            "description": "Export the tab at this position, counting from 1 in tab order. Hidden sheets count. Don't send it together with `WorksheetName`: the pair returns 400 \"send WorksheetName or WorksheetIndex, not both\".\n\nValues: 1 to the number of sheets."
          },
          "ActiveWorksheetOnly": {
            "type": "boolean",
            "default": false,
            "description": "With `true`, export the tab that was open when the file was saved instead of the first one: a test workbook saved with its second tab open exported that tab. `WorksheetName` or `WorksheetIndex` wins when sent with it. It also works on `xlsb/to/csv`: our two-tab XLSB test file, saved with its Daily tab open, exported Daily. On `ods/to/csv` it returns 400 for now."
          },
          "Password": {
            "type": "string",
            "description": "Opens a workbook saved with a password to open, as Excel 2010 and later encrypt it: a protected copy of the sample gave the same 661-byte CSV. Protected .xls files can't be opened on this route yet (400 with a password, 422 without). Sent with a workbook that has no password, it changes nothing."
          },
          "Delimiter": {
            "type": "string",
            "default": ",",
            "description": "Separator written between fields. A field that contains it, a double quote or a line break is wrapped in double quotes.\n\nValues: One ASCII character, or `tab`."
          },
          "FileName": {
            "type": "string",
            "description": "Name for the CSV file, without the extension. Without it the CSV takes the uploaded file's name."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Return a download link instead of the file. The link expires after 3 hours and the file is then deleted."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `xlsx/to/csv`, `xls/to/csv`, `xlsb/to/csv`, `ods/to/csv`: the parameters listed on https://pdfconversionapi.com/convert/xlsx-to-csv. Other parameters are sent as text."
      },
      "XlsxToPdfForm": {
        "type": "object",
        "required": ["File"],
        "properties": {
          "File": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream",
            "description": "The file to convert. Its name becomes the output's name, with the new extension."
          },
          "WorksheetName": {
            "type": "string",
            "description": "Print only this sheet; the name is matched without regard to case. `WorksheetName=Orders` returned the sample's 2 Orders pages. A name the workbook doesn't have returns 400 \"no worksheet named 'Nope'\", and sending it together with `WorksheetIndex` returns 400."
          },
          "WorksheetIndex": {
            "type": "integer",
            "minimum": 1,
            "maximum": 2000,
            "description": "Print only the sheet at this position in the tab order, hidden sheets included: 2 is Orders, and 3 prints the hidden Rates sheet on its own A4 page. A number past the last sheet returns 400 \"WorksheetIndex is 4, but the workbook has 3 worksheets\"."
          },
          "ActiveWorksheetOnly": {
            "type": "boolean",
            "default": false,
            "description": "Print only the sheet that was open when the file was saved. For the sample that is Summary, a single landscape page."
          },
          "PageSize": {
            "type": "string",
            "enum": ["letter", "legal", "tabloid", "ledger", "executive", "statement", "a3", "a4", "a5", "b4", "b5", "default"],
            "default": "default",
            "description": "Paper for every printed sheet, replacing the size saved in the file; each sheet keeps its orientation. `PageSize=a4` printed the Summary page at 11.69 × 8.27 in and the Orders pages at 8.27 × 11.69 in."
          },
          "PageOrientation": {
            "type": "string",
            "enum": ["default", "portrait", "landscape"],
            "default": "default",
            "description": "Turns every printed sheet. `landscape` laid Orders out on 3 wide pages instead of 2 tall ones; `portrait` stood the Summary page upright."
          },
          "Scale": {
            "type": "integer",
            "minimum": 10,
            "maximum": 300,
            "description": "Print every sheet at this percentage instead of the scaling saved in the file. It switches off a sheet's saved fit-to-page setting: at 50, the sample's Summary table took half the page width it fills by default.\n\nValues: 10–300 (percent)."
          },
          "FitToPage": {
            "type": "boolean",
            "default": false,
            "description": "Shrink each sheet to one page wide, with as many pages down as it needs. A 150-row, 12-column test sheet whose last columns spilled onto pages of their own went from 8 pages to 3, all of them A4. The sample's sheets already fit their width, so nothing changes there."
          },
          "HeaderOnEachPage": {
            "type": "boolean",
            "default": false,
            "description": "Repeat the first row that holds data at the top of every page. On our 150-row test sheet, page 2 then began with the header row. The sample's Orders sheet already repeats its header through the file's print titles."
          },
          "ClearPrintArea": {
            "type": "boolean",
            "default": false,
            "description": "Ignore print areas saved in the sheets and print every used cell. A test sheet with a print area of A1:C20 printed 1 page by default and 8 with this option."
          },
          "PageRange": {
            "type": "string",
            "description": "Pages to keep, counted in the finished PDF across all sheets. In the sample, Summary is page 1 and Orders is pages 2 and 3. A range may end past the last page, so `1-10` returns all 3 pages, but a page that doesn't exist, such as `5`, returns 400 with the real page count.\n\nValues: e.g. `1-3,5`, `2-` or `2-last`."
          },
          "Pdfa": {
            "type": "boolean",
            "default": false,
            "description": "Write the PDF as PDF/A-1b. For 2b or 3b, use `PdfaVersion`."
          },
          "PdfaVersion": {
            "type": "string",
            "enum": ["none", "pdfA1b", "pdfA2b", "pdfA3b"],
            "default": "none",
            "description": "Choose the PDF/A version instead. Sent together with `Pdfa=true`, `PdfaVersion` decides: the pair with `pdfA2b` gave PDF/A-2b. A `PageRange` that leaves pages out can't be combined with either one, but `WorksheetName` can: `WorksheetName=Orders` with `PdfaVersion=pdfA2b` returned the 2 Orders pages as PDF/A-2b."
          },
          "Password": {
            "type": "string",
            "description": "Opens a workbook saved with a password to open, as Excel 2010 and later encrypt it. A protected copy of the sample gave the same 3 pages. Files using Office 2007's older encryption return 422. Sent with a workbook that has no password, it changes nothing."
          },
          "FileName": {
            "type": "string",
            "description": "Base name for the PDF. Without it, `store-sales-q3.xlsx` becomes `store-sales-q3.pdf`."
          },
          "StoreFile": {
            "type": "boolean",
            "default": false,
            "description": "Keep the PDF on our side and answer with a link to it instead of the file. Links expire 3 hours after the conversion."
          }
        },
        "additionalProperties": {"type": "string"},
        "description": "The form for `xlsx/to/pdf`, `xls/to/pdf`, `xlsb/to/pdf`, `ods/to/pdf`: the parameters listed on https://pdfconversionapi.com/convert/xlsx-to-pdf. Other parameters are sent as text."
      }
    },
    "responses": {
      "BadRequest": {
        "description": "The request can't be used as sent: no file, too many files, a bad parameter value, a format name with characters other than letters, digits and `-`, or an option this conversion doesn't apply. The message names the parameter. A body that isn't a multipart form gets this status with a plain-text body.",
        "headers": {
          "x-request-id": {"$ref": "#/components/headers/RequestId"}
        },
        "content": {
          "application/json": {
            "schema": {"$ref": "#/components/schemas/Error"},
            "example": {"Code": 400, "Message": "PageRange is not supported yet for DOCX → PDF"}
          },
          "text/plain": {
            "schema": {"type": "string"},
            "example": "Invalid `boundary` for `multipart/form-data` request"
          }
        }
      },
      "Unauthorized": {
        "description": "The key is missing or unknown, or it was replaced or its account deleted.",
        "headers": {
          "x-request-id": {"$ref": "#/components/headers/RequestId"},
          "WWW-Authenticate": {
            "description": "Always `Bearer`.",
            "schema": {"type": "string", "const": "Bearer"}
          }
        },
        "content": {
          "application/json": {
            "schema": {"$ref": "#/components/schemas/Error"},
            "example": {"Code": 401, "Message": "a valid API key is required (Authorization: Bearer <key>)"}
          }
        }
      },
      "Forbidden": {
        "description": "The key's plan isn't set up on our side. Write to support.",
        "headers": {
          "x-request-id": {"$ref": "#/components/headers/RequestId"}
        },
        "content": {
          "application/json": {
            "schema": {"$ref": "#/components/schemas/Error"},
            "example": {"Code": 403, "Message": "this key's plan is not set up; write to support"}
          }
        }
      },
      "NotFound": {
        "description": "We don't convert between these two formats, the path doesn't exist, or a stored file's link has expired or the file was deleted.",
        "headers": {
          "x-request-id": {"$ref": "#/components/headers/RequestId"}
        },
        "content": {
          "application/json": {
            "schema": {"$ref": "#/components/schemas/Error"},
            "example": {"Code": 404, "Message": "conversion from docx to dwg is not supported"}
          }
        }
      },
      "PayloadTooLarge": {
        "description": "The request is over your plan's upload size (10 MB on the Free plan and 100 MB on paid plans; all files and fields together), or a result passed a limit such as 512 MB per output file, 100,000,000 pixels per image or 2,000 pages per request. HTML that needs a browser must fit in 25 MB. A request close to 100 MB can also be refused by the network in front of the API with an HTML 413 page and no `x-request-id`. [Limits](https://pdfconversionapi.com/docs/limits)",
        "headers": {
          "x-request-id": {"$ref": "#/components/headers/RequestId"}
        },
        "content": {
          "application/json": {
            "schema": {"$ref": "#/components/schemas/Error"},
            "example": {"Code": 413, "Message": "the Free plan accepts uploads up to 10 MB, all files together"}
          }
        }
      },
      "Unprocessable": {
        "description": "The file can't be read as the format in the URL, needs a password that wasn't sent, or is a restricted or signed PDF that this conversion would rewrite. The message says which.",
        "headers": {
          "x-request-id": {"$ref": "#/components/headers/RequestId"}
        },
        "content": {
          "application/json": {
            "schema": {"$ref": "#/components/schemas/Error"},
            "example": {"Code": 422, "Message": "the input file is password-protected"}
          }
        }
      },
      "TooManyRequests": {
        "description": "One of three limits, named in the message: more than 600 requests in 60 seconds from the account (`Retry-After: 10`); all the conversions the plan runs at once are busy (`Retry-After: 5`); or this month's conversions on the plan are used up (`Retry-After` runs to 00:00 UTC on the first day of next month). Every plan stops at its limit; nothing past it is billed.",
        "headers": {
          "x-request-id": {"$ref": "#/components/headers/RequestId"},
          "Retry-After": {"$ref": "#/components/headers/RetryAfter"}
        },
        "content": {
          "application/json": {
            "schema": {"$ref": "#/components/schemas/Error"},
            "example": {"Code": 429, "Message": "too many requests; slow down"}
          }
        }
      },
      "InternalError": {
        "description": "A failure on our side. Retry once; if it fails again, write to support with the `x-request-id`.",
        "headers": {
          "x-request-id": {"$ref": "#/components/headers/RequestId"}
        },
        "content": {
          "application/json": {
            "schema": {"$ref": "#/components/schemas/Error"},
            "example": {"Code": 500, "Message": "internal error"}
          }
        }
      },
      "ServiceUnavailable": {
        "description": "No conversion slot came free within 20 seconds (`Retry-After: 5`), or conversions on the plan are paused for a while (`Retry-After: 600`). Retry after the wait, with backoff and jitter.",
        "headers": {
          "x-request-id": {"$ref": "#/components/headers/RequestId"},
          "Retry-After": {"$ref": "#/components/headers/RetryAfter"}
        },
        "content": {
          "application/json": {
            "schema": {"$ref": "#/components/schemas/Error"},
            "example": {"Code": 503, "Message": "the server is busy; retry shortly"}
          }
        }
      },
      "Timeout": {
        "description": "The conversion ran past 120 seconds. Retrying the same file with the same options will most likely time out again. A request with no answer after 170 seconds gets this status with an empty body, although its `Content-Type` says `application/json`.",
        "headers": {
          "x-request-id": {"$ref": "#/components/headers/RequestId"}
        },
        "content": {
          "application/json": {
            "schema": {"$ref": "#/components/schemas/Error"},
            "example": {"Code": 504, "Message": "the conversion timed out"}
          }
        }
      },
      "Converted": {
        "description": "The conversion succeeded. Every output file is in `Files`.",
        "headers": {
          "x-request-id": {"$ref": "#/components/headers/RequestId"}
        },
        "content": {
          "application/json": {
            "schema": {"$ref": "#/components/schemas/ConversionResult"},
            "example": {
              "ConversionCost": 1,
              "ConversionTime": 0.066,
              "Files": [
                {
                  "FileName": "report.pdf",
                  "FileExt": "pdf",
                  "FileSize": 82830,
                  "FileData": "JVBERi0xLjcKJYCAgIAKMSAwIG9iago8PC9UeXBl"
                }
              ]
            }
          }
        }
      }
    }
  }
}
