{
  "service": "convertapi",
  "displayName": "ConvertAPI",
  "categories": [
    "Productivity",
    "Design & Media"
  ],
  "authTypes": [
    "api_key"
  ],
  "auth": [
    {
      "type": "api_key",
      "label": "API Token",
      "placeholder": "CONVERTAPI_API_TOKEN",
      "description": "ConvertAPI API token sent as a Bearer token. Create and manage API tokens in the ConvertAPI authentication dashboard: https://www.convertapi.com/a/authentication."
    }
  ],
  "homepageUrl": "https://www.convertapi.com",
  "actions": [
    {
      "id": "convertapi.convert_pdf_to_docx",
      "service": "convertapi",
      "name": "convert_pdf_to_docx",
      "description": "Convert a publicly accessible PDF URL to DOCX with ConvertAPI and return temporary file download URLs.",
      "requiredScopes": [],
      "providerPermissions": [],
      "inputSchema": {
        "type": "object",
        "properties": {
          "fileUrl": {
            "type": "string",
            "description": "The publicly accessible PDF URL to convert.",
            "format": "uri"
          },
          "fileName": {
            "type": "string",
            "maxLength": 200,
            "description": "The optional output file name to request from ConvertAPI. ConvertAPI appends the correct extension when needed."
          },
          "timeout": {
            "type": "integer",
            "minimum": 10,
            "maximum": 1200,
            "description": "The conversion timeout in seconds."
          },
          "password": {
            "type": "string",
            "description": "The password used to open a protected PDF document."
          },
          "pageRange": {
            "type": "string",
            "description": "The PDF page range to convert, for example 1-10 or 1,3,5."
          },
          "layout": {
            "type": "string",
            "enum": [
              "flowing",
              "continuous",
              "exact"
            ],
            "description": "How ConvertAPI should reconstruct the PDF page layout in the DOCX output."
          },
          "ocrMode": {
            "type": "string",
            "enum": [
              "auto",
              "force",
              "never"
            ],
            "description": "How ConvertAPI should apply OCR during conversion."
          },
          "ocrLanguage": {
            "type": "string",
            "enum": [
              "auto",
              "ar",
              "ca",
              "zh",
              "da",
              "nl",
              "en",
              "fi",
              "fr",
              "de",
              "el",
              "ko",
              "it",
              "ja",
              "no",
              "pl",
              "pt",
              "ro",
              "ru",
              "sl",
              "es",
              "sv",
              "tr",
              "ua",
              "th"
            ],
            "description": "The OCR language code to use for text recognition, or auto for automatic detection."
          },
          "ocrEngine": {
            "type": "string",
            "enum": [
              "native",
              "tesseract"
            ],
            "description": "The OCR engine ConvertAPI should use for text recognition."
          },
          "annotations": {
            "type": "string",
            "enum": [
              "textBox",
              "comment",
              "none"
            ],
            "description": "How ConvertAPI should handle PDF annotations in the DOCX output."
          }
        },
        "additionalProperties": false,
        "required": [
          "fileUrl"
        ],
        "description": "The input payload for converting a public PDF URL to a DOCX file with ConvertAPI."
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "conversionCost": {
            "type": "integer",
            "description": "The amount deducted from the ConvertAPI balance."
          },
          "files": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "fileName": {
                  "type": "string",
                  "description": "The converted file name."
                },
                "fileExt": {
                  "type": "string",
                  "description": "The converted file extension."
                },
                "fileSize": {
                  "type": "integer",
                  "description": "The converted file size in bytes."
                },
                "fileId": {
                  "type": "string",
                  "description": "The ConvertAPI temporary file ID."
                },
                "url": {
                  "type": "string",
                  "description": "The ConvertAPI temporary download URL for the converted file.",
                  "format": "uri"
                },
                "transitFile": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "fileId": {
                          "type": "string",
                          "minLength": 1,
                          "description": "The local transit file identifier."
                        },
                        "downloadUrl": {
                          "type": "string",
                          "description": "The local URL for downloading the transit file.",
                          "format": "uri"
                        },
                        "sizeBytes": {
                          "type": "number",
                          "description": "The transit file size in bytes."
                        },
                        "name": {
                          "type": "string",
                          "minLength": 1,
                          "description": "The transit file name."
                        },
                        "mimeType": {
                          "type": "string",
                          "minLength": 1,
                          "description": "The transit file MIME type."
                        }
                      },
                      "additionalProperties": false,
                      "description": "A copy of a converted file stored in local transit storage."
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "additionalProperties": false,
              "description": "A converted file returned by ConvertAPI."
            },
            "description": "The converted DOCX files returned by ConvertAPI.",
            "minItems": 1
          }
        },
        "additionalProperties": false,
        "required": [
          "files"
        ],
        "description": "The output payload for a ConvertAPI PDF to DOCX conversion."
      }
    }
  ]
}