{ "openapi": "3.0.1", "info": { "title": "ConvertAPI", "description": "# High-Performance File Conversion API\nConvert Word, Excel, PowerPoint, HTML, PDF and Image formats with our powerful file conversion service.\nWe support more than [200 file types.]( https://www.convertapi.com/doc/file-formats)", "termsOfService": "https://www.convertapi.com/terms", "contact": { "url": "https://www.convertapi.com/support", "email": "support@convertapi.com" }, "license": { "name": "Apache 2.0", "url": "http://www.apache.org/licenses/LICENSE-2.0.html" }, "version": "v2" }, "servers": [ { "url": "https://v2.convertapi.com" }, { "url": "https://eu-v2.convertapi.com" }, { "url": "https://uk-v2.convertapi.com" }, { "url": "https://us-v2.convertapi.com" }, { "url": "https://ca-v2.convertapi.com" }, { "url": "https://as-v2.convertapi.com" }, { "url": "https://au-v2.convertapi.com" } ], "paths": { "/convert/pdf/to/watermark-textbox": { "summary": "Text Box Watermark PDF API", "description": "Stamp a PDF with the text box. \n Read more about the converter here: https://www.convertapi.com/pdf-to-watermark-textbox", "post": { "tags": [ "Conversion" ], "requestBody": { "content": { "multipart/form-data": { "schema": { "required": [ "File", "Text" ], "type": "object", "properties": { "Timeout": { "maximum": 1200, "minimum": 10, "type": "integer", "description": "Conversion timeout in seconds.", "default": 900, "x-ca-featured": false, "x-ca-label": "Timeout", "x-ca-group": "Execution", "x-ca-representation": "Default", "x-ca-range": { "from": "10", "to": "1200" } }, "StoreFile": { "type": "boolean", "description": "When the `StoreFile` parameter is set to `True`, your converted file is written to ConvertAPI’s encrypted, temporary storage and made available via a time-limited secure download URL, valid for up to 3 hours. After this period, the file is permanently deleted.\r\n\r\nWhen `StoreFile` is set to `False`, conversion happens entirely in-memory. The raw file bytes are streamed back in the API response without touching disk or external storage, ensuring maximum security and zero persistence so that only you can access the content.\r\n", "default": false, "x-ca-featured": false, "x-ca-label": "Store file", "x-ca-group": "Output", "x-ca-representation": "Default" }, "File": { "type": "string", "description": "File to be converted. Value can be URL or file content.", "format": "binary", "x-ca-featured": true, "x-ca-label": "File", "x-ca-group": "Input", "x-ca-representation": "Default" }, "FileName": { "type": "string", "description": "The `FileName` property defines the name of the output file(s) generated by the file conversion API, ensuring safe and\r\nunique file naming. It sanitizes input filenames to remove potentially harmful characters, automatically appends the\r\ncorrect file extension based on the target format, and includes an indexing feature to distinguish multiple output files\r\nfrom a single input. For example, converting `report.docx` to PDF format might result in `report.pdf` for a single file,\r\nor `report_0.pdf`, `report_1.pdf` for multiple files, ensuring each output file is uniquely identifiable.", "x-ca-featured": false, "x-ca-label": "Output file name", "x-ca-group": "Output", "x-ca-representation": "Default", "x-ca-range": { "from": "1", "to": "200" } }, "Password": { "type": "string", "description": "Sets the password to open protected documents.", "x-ca-featured": false, "x-ca-label": "Open Password", "x-ca-group": "Document", "x-ca-representation": "Default" }, "Text": { "type": "string", "description": "Specifies the text to use as text box watermark. The list of supported variables: %N% - new line, %PAGE% - current page number, %PAGES% - total number of pages, %FILENAME% - name of the file, %WEEKDAY% - full weekday name, %WEEKDAY_SHORT% - abbreviated weekday name, %MONTH% - month number (1-12), %MONTHNAME% - full month name, %MONTHNAME_SHORT% - abbreviated month name, %YEAR% - year with century (YYYY), %YEAR_SHORT% - year without century (YY), %DAY% - day of month, %DAY_YEAR% - day of the year (1 -366), %HOUR% - hour (01- 12), %HOURS% - hour (00-23), %MINUTES% - minutes (00-59), %SECONDS% - seconds (00-59), %AMPM% - AM PM, %DATE% - local date representation, %TIME% - local time representation, %DATETIME% - local date and time, %AUTHOR% - document Author, %TITLE% - document Title, %SUBJECT% - document Subject, %KEYWORDS% - document Keywords.", "x-ca-featured": true, "x-ca-label": "Watermark text", "x-ca-group": "Watermark", "x-ca-representation": "Default" }, "TextAlign": { "enum": [ "left", "center", "right" ], "type": "string", "description": "Specifies the watermark text align.\n * `left` - Left\n * `center` - Center\n * `right` - Right", "default": "left", "x-ca-featured": false, "x-ca-label": "Watermark text align", "x-ca-group": "Watermark", "x-ca-representation": "Dropdown", "x-ca-values": { "left": "Left", "center": "Center", "right": "Right" } }, "WordWrap": { "type": "boolean", "description": "Specifies whether to enable word wrap in case text does not fit in one line.", "default": false, "x-ca-featured": false, "x-ca-label": "Watermark text word wrap", "x-ca-group": "Watermark", "x-ca-representation": "Default" }, "LineSpacing": { "maximum": 30, "minimum": 0, "type": "integer", "description": "Specifies the watermark text line spacing.", "default": 5, "x-ca-featured": false, "x-ca-label": "Watermark text line spacing", "x-ca-group": "Watermark", "x-ca-representation": "Default", "x-ca-range": { "from": "0", "to": "30" } }, "FontName": { "enum": [ "Arial", "Bahnschrift", "Calibri", "Cambria", "Consolas", "Constantia", "Courier New", "Georgia", "Tahoma", "Times New Roman", "Verdana" ], "type": "string", "description": "Specifies the watermark font name. Contact us if you are looking for a specific font for a watermark that is missing from the list.\n * `Arial` - Arial\n * `Bahnschrift` - Bahnschrift\n * `Calibri` - Calibri\n * `Cambria` - Cambria\n * `Consolas` - Consolas\n * `Constantia` - Constantia\n * `Courier New` - Courier New\n * `Georgia` - Georgia\n * `Tahoma` - Tahoma\n * `Times New Roman` - Times New Roman\n * `Verdana` - Verdana", "default": "Arial", "x-ca-featured": false, "x-ca-label": "Watermark font name", "x-ca-group": "Watermark", "x-ca-representation": "Dropdown", "x-ca-values": { "Arial": "Arial", "Bahnschrift": "Bahnschrift", "Calibri": "Calibri", "Cambria": "Cambria", "Consolas": "Consolas", "Constantia": "Constantia", "Courier New": "Courier New", "Georgia": "Georgia", "Tahoma": "Tahoma", "Times New Roman": "Times New Roman", "Verdana": "Verdana" } }, "FontSize": { "maximum": 200, "minimum": 1, "type": "integer", "description": "Specifies the watermark font size.", "default": 40, "x-ca-featured": false, "x-ca-label": "Watermark font size", "x-ca-group": "Watermark", "x-ca-representation": "Default", "x-ca-range": { "from": "1", "to": "200" } }, "FontColor": { "type": "string", "description": "Specifies the watermark font color.", "default": "#ffffff", "x-ca-featured": false, "x-ca-label": "Watermark font color", "x-ca-group": "Watermark", "x-ca-representation": "Default" }, "StrokeColor": { "type": "string", "description": "Specifies font stroke color.", "default": "#271851", "x-ca-featured": false, "x-ca-label": "Stroke color", "x-ca-group": "Watermark", "x-ca-representation": "Default" }, "StrokeWidth": { "maximum": 200, "minimum": 0, "type": "integer", "description": "Specifies the stroke width.", "default": 1, "x-ca-featured": false, "x-ca-label": "Stroke width", "x-ca-group": "Watermark", "x-ca-representation": "Default", "x-ca-range": { "from": "0", "to": "200" } }, "FontEmbed": { "type": "boolean", "description": "Specifies whether fonts should be embedded.", "default": true, "x-ca-featured": false, "x-ca-label": "Embed watermark font", "x-ca-group": "Watermark", "x-ca-representation": "Default" }, "FontSubset": { "type": "boolean", "description": "Specifies whether fonts should be subset.", "default": true, "x-ca-featured": false, "x-ca-label": "Font subset", "x-ca-group": "Watermark", "x-ca-representation": "Default" }, "FontEncoding": { "type": "string", "description": "Specifies the font encoding.", "x-ca-featured": false, "x-ca-label": "Font encoding", "x-ca-group": "Watermark", "x-ca-representation": "Default" }, "TextRenderingMode": { "enum": [ "filltext", "stroketext", "fillstroke", "invisible" ], "type": "string", "description": "Specifies the text rendering mode.\n * `filltext` - Fill text without stroke\n * `stroketext` - Stroke text without fill\n * `fillstroke` - Fill and stroke\n * `invisible` - Invisible", "default": "fillstroke", "x-ca-featured": false, "x-ca-label": "Text rendering mode", "x-ca-group": "Watermark", "x-ca-representation": "Dropdown", "x-ca-values": { "filltext": "Fill text without stroke", "stroketext": "Stroke text without fill", "fillstroke": "Fill and stroke", "invisible": "Invisible" } }, "Rotate": { "maximum": 360, "minimum": 0, "type": "integer", "description": "Specifies the watermark rotation angle in degrees.", "default": 0, "x-ca-featured": false, "x-ca-label": "Rotate watermark", "x-ca-group": "Watermark", "x-ca-representation": "Default", "x-ca-range": { "from": "0", "to": "360" } }, "PageRange": { "type": "string", "description": "Set page range. Example 1-10 or 1,2,5.", "default": "1-2000", "x-ca-featured": false, "x-ca-label": "Page Range", "x-ca-group": "Document", "x-ca-representation": "Default", "x-ca-range": { "from": "1", "to": "2000" } }, "Opacity": { "maximum": 100, "minimum": 0, "type": "integer", "description": "Specifies watermark opacity level.", "default": 100, "x-ca-featured": false, "x-ca-label": "Opacity level", "x-ca-group": "Watermark", "x-ca-representation": "Default", "x-ca-range": { "from": "0", "to": "100" } }, "Style": { "enum": [ "stamp", "watermark" ], "type": "string", "description": "Specifies watermark style, stamp or watermark. The stamp is placed over page content and watermark under page content.\n * `stamp` - Stamp\n * `watermark` - Watermark", "default": "stamp", "x-ca-featured": false, "x-ca-label": "Watermark style", "x-ca-group": "Watermark", "x-ca-representation": "Dropdown", "x-ca-values": { "stamp": "Stamp", "watermark": "Watermark" } }, "GoToLink": { "type": "string", "description": "Specifies the web address to go when the watermark is clicked.", "x-ca-featured": false, "x-ca-label": "Go to web link", "x-ca-group": "Watermark", "x-ca-representation": "Default" }, "GoToPage": { "type": "string", "description": "Specifies the page number to go when the watermark is clicked.", "x-ca-featured": false, "x-ca-label": "Go to page", "x-ca-group": "Watermark", "x-ca-representation": "Default" }, "PageRotation": { "type": "boolean", "description": "Specifies whether to use the page rotation parameter when placing watermark.", "default": false, "x-ca-featured": false, "x-ca-label": "Use page rotation", "x-ca-group": "Watermark", "x-ca-representation": "Default" }, "CropBox": { "type": "boolean", "description": "Specifies whether to use the page crop box to position watermark.", "default": false, "x-ca-featured": false, "x-ca-label": "Use crop box", "x-ca-group": "Watermark", "x-ca-representation": "Default" }, "HorizontalAlignment": { "enum": [ "left", "center", "right" ], "type": "string", "description": "Specifies the horizontal watermark alignment.\n * `left` - left\n * `center` - center\n * `right` - right", "default": "center", "x-ca-featured": false, "x-ca-label": "Horizontal watermark alignment", "x-ca-group": "Watermark", "x-ca-representation": "Dropdown", "x-ca-values": { "left": "left", "center": "center", "right": "right" } }, "VerticalAlignment": { "enum": [ "top", "center", "bottom" ], "type": "string", "description": "Specifies the vertical watermark alignment.\n * `top` - top\n * `center` - center\n * `bottom` - bottom", "default": "center", "x-ca-featured": false, "x-ca-label": "Vertical watermark alignment", "x-ca-group": "Watermark", "x-ca-representation": "Dropdown", "x-ca-values": { "top": "top", "center": "center", "bottom": "bottom" } }, "PositionX": { "maximum": 10000, "minimum": 1, "type": "integer", "description": "Specifies the watermark X coordinate. If set overrides property HorizontalAlignment.", "x-ca-featured": false, "x-ca-label": "Watermark X coordinate", "x-ca-group": "Watermark", "x-ca-representation": "Default", "x-ca-range": { "from": "1", "to": "10000" } }, "PositionY": { "maximum": 10000, "minimum": 1, "type": "integer", "description": "Specifies the watermark Y coordinate. If set overrides property VerticalAlignment.", "x-ca-featured": false, "x-ca-label": "Watermark Y coordinate", "x-ca-group": "Watermark", "x-ca-representation": "Default", "x-ca-range": { "from": "1", "to": "10000" } }, "PositionUnit": { "enum": [ "pt", "in", "mm", "cm" ], "type": "string", "description": "Specifies measurement unit to use for the PositionX and PositionY properties.\n * `pt` - Points\n * `in` - Inches\n * `mm` - Millimeters\n * `cm` - Centimeters", "default": "pt", "x-ca-featured": false, "x-ca-label": "Watermark position unit", "x-ca-group": "Watermark", "x-ca-representation": "Dropdown", "x-ca-values": { "pt": "Points", "in": "Inches", "mm": "Millimeters", "cm": "Centimeters" } }, "Height": { "maximum": 10000, "minimum": 10, "type": "integer", "description": "Specifies the watermark height.", "default": 500, "x-ca-featured": false, "x-ca-label": "Watermark Height", "x-ca-group": "Watermark", "x-ca-representation": "Default", "x-ca-range": { "from": "10", "to": "10000" } }, "Width": { "maximum": 10000, "minimum": 10, "type": "integer", "description": "Specifies the watermark width.", "default": 500, "x-ca-featured": false, "x-ca-label": "Watermark width", "x-ca-group": "Watermark", "x-ca-representation": "Default", "x-ca-range": { "from": "10", "to": "10000" } }, "PdfVersion": { "enum": [ "1.2", "1.3", "1.4", "1.5", "1.6", "1.7", "1.8", "2.0" ], "type": "string", "description": "Set PDF version.\n * `1.2` - Acrobat 3 (PDF 1.2)\n * `1.3` - Acrobat 4 (PDF 1.3)\n * `1.4` - Acrobat 5 (PDF 1.4)\n * `1.5` - Acrobat 6 (PDF 1.5)\n * `1.6` - Acrobat 7 (PDF 1.6)\n * `1.7` - Acrobat 8 (PDF 1.7)\n * `1.8` - Acrobat 9 (PDF 1.7, e-level 3)\n * `2.0` - Acrobat DC (PDF 2.0)", "default": "1.5", "x-ca-featured": false, "x-ca-label": "PDF version", "x-ca-group": "PDF Output", "x-ca-representation": "Dropdown", "x-ca-values": { "1.2": "Acrobat 3 (PDF 1.2)", "1.3": "Acrobat 4 (PDF 1.3)", "1.4": "Acrobat 5 (PDF 1.4)", "1.5": "Acrobat 6 (PDF 1.5)", "1.6": "Acrobat 7 (PDF 1.6)", "1.7": "Acrobat 8 (PDF 1.7)", "1.8": "Acrobat 9 (PDF 1.7, e-level 3)", "2.0": "Acrobat DC (PDF 2.0)" } }, "PdfResolution": { "maximum": 2400, "minimum": 10, "type": "integer", "description": "Set PDF resolution.", "default": 300, "x-ca-featured": false, "x-ca-label": "PDF resolution", "x-ca-group": "PDF Output", "x-ca-representation": "Default", "x-ca-range": { "from": "10", "to": "2400" } }, "PdfTitle": { "type": "string", "description": "Provide a value to customize the PDF title. Otherwise, the default document title will be used. Use single quotes and a space (' ') to remove the title.", "x-ca-featured": false, "x-ca-label": "PDF title", "x-ca-group": "PDF Output", "x-ca-representation": "Default" }, "PdfSubject": { "type": "string", "description": "Provide a value to customize the PDF subject. Otherwise, the default document subject will be used. Use single quotes and a space (' ') to remove the subject.", "x-ca-featured": false, "x-ca-label": "PDF subject", "x-ca-group": "PDF Output", "x-ca-representation": "Default" }, "PdfAuthor": { "type": "string", "description": "Provide a value to customize the PDF author. Otherwise, the default document author will be used. Use single quotes and a space (' ') to remove the author.", "x-ca-featured": false, "x-ca-label": "PDF author", "x-ca-group": "PDF Output", "x-ca-representation": "Default" }, "PdfKeywords": { "type": "string", "description": "Provide a value to customize the PDF keywords. Otherwise, the default document keywords will be used. Use single quotes and a space (' ') to remove the keywords.", "x-ca-featured": false, "x-ca-label": "PDF keywords", "x-ca-group": "PDF Output", "x-ca-representation": "Default" }, "OpenPage": { "maximum": 3000, "minimum": 1, "type": "integer", "description": "Set the page number at which the PDF document should open.", "default": 1, "x-ca-featured": false, "x-ca-label": "Open to page", "x-ca-group": "PDF Output", "x-ca-representation": "Default", "x-ca-range": { "from": "1", "to": "3000" } }, "OpenZoom": { "enum": [ "Default", "ActualSize", "FitPage", "FitWidth", "FitHeight", "FitVisible", "25", "50", "75", "100", "125", "150", "200", "400", "800", "1600", "2400", "3200", "6400" ], "type": "string", "description": "Set the default zoom percentage for when you open PDF files .\n * `Default` - Default\n * `ActualSize` - Actual Size\n * `FitPage` - Fit Page\n * `FitWidth` - Fit Width\n * `FitHeight` - Fit Height\n * `FitVisible` - Fit Visible\n * `25` - 25%\n * `50` - 50%\n * `75` - 75%\n * `100` - 100%\n * `125` - 125%\n * `150` - 150%\n * `200` - 200%\n * `400` - 400%\n * `800` - 800%\n * `1600` - 1600%\n * `2400` - 2400%\n * `3200` - 3200%\n * `6400` - 6400%", "default": "Default", "x-ca-featured": false, "x-ca-label": "PDF default zoom", "x-ca-group": "PDF Output", "x-ca-representation": "Dropdown", "x-ca-values": { "Default": "Default", "ActualSize": "Actual Size", "FitPage": "Fit Page", "FitWidth": "Fit Width", "FitHeight": "Fit Height", "FitVisible": "Fit Visible", "25": "25%", "50": "50%", "75": "75%", "100": "100%", "125": "125%", "150": "150%", "200": "200%", "400": "400%", "800": "800%", "1600": "1600%", "2400": "2400%", "3200": "3200%", "6400": "6400%" } }, "RotatePage": { "enum": [ "Disabled", "ByPage", "All" ], "type": "string", "description": "Automatically rotate pages based on the orientation of the text. By Page option will rotate each page based on the direction of the text on that page. All option will rotate all pages in the document based on the orientation of the majority of text.\n * `Disabled` - Disabled\n * `ByPage` - By Page\n * `All` - All", "default": "ByPage", "x-ca-featured": false, "x-ca-label": "Auto rotate page", "x-ca-group": "PDF Output", "x-ca-representation": "Dropdown", "x-ca-values": { "Disabled": "Disabled", "ByPage": "By Page", "All": "All" } }, "EmbedFonts": { "type": "boolean", "description": "Embed fonts in PDF.", "default": true, "x-ca-featured": false, "x-ca-label": "Embed fonts", "x-ca-group": "PDF Fonts", "x-ca-representation": "Default" }, "SubsetFonts": { "type": "boolean", "description": "Include in the output PDF document only the font characters that are used in the original document.", "default": true, "x-ca-featured": false, "x-ca-label": "Subset fonts", "x-ca-group": "PDF Fonts", "x-ca-representation": "Default" }, "SubsetFontsThreshold": { "maximum": 100, "minimum": 0, "type": "integer", "description": "Sets the Subset Fonts threshold. If the percentage of used characters, compared with total characters of the particular font, exceeds this threshold, the entire font is embedded.", "default": 100, "x-ca-featured": false, "x-ca-label": "Subset fonts threshold", "x-ca-group": "PDF Fonts", "x-ca-representation": "Default", "x-ca-range": { "from": "0", "to": "100" } }, "ColorSpace": { "enum": [ "Default", "RGB", "CMYK", "Gray" ], "type": "string", "description": "Set PDF color space.\n * `Default` - Default\n * `RGB` - RGB\n * `CMYK` - CMYK\n * `Gray` - Gray", "default": "Default", "x-ca-featured": false, "x-ca-label": "PDF color space", "x-ca-group": "PDF Output", "x-ca-representation": "Dropdown", "x-ca-values": { "Default": "Default", "RGB": "RGB", "CMYK": "CMYK", "Gray": "Gray" } } } } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "ConversionCost": { "type": "integer", "description": "This amount will be deducted from your balance after the conversion.", "format": "int32", "example": 1 }, "Files": { "type": "array", "items": { "type": "object", "properties": { "FileName": { "type": "string", "description": "Name of the converted file.", "example": "myfile.pdf" }, "FileExt": { "type": "string", "description": "File type (file name extension)", "example": "pdf" }, "FileSize": { "type": "integer", "description": "File size", "format": "int32", "example": 111955 }, "FileId": { "type": "string", "description": "File ID", "example": "25811safe8e61dd3f51ef00ee5f58b92" }, "Url": { "type": "string", "description": "File URL", "example": "https://v2.convertapi.com/d/v01plsb72o0cmdooq90w4d1lnqsf6oy4/myfile.pdf" }, "FileData": { "type": "string", "description": "Base64 encoded file data", "format": "base64", "example": "JVBERi0xLjcKJb662+4KMSAwIG9iago8PC9UeXBlIC9DYXRhbG9n..." } } } } }, "externalDocs": { "url": "https://www.convertapi.com/doc/content-types#applicationjson-1" } } }, "multipart/mixed": { "schema": { "type": "string", "format": "binary", "externalDocs": { "url": "https://www.convertapi.com/doc/content-types#multipartmixed" } }, "example": "--43cf1475-ab15-4c6b-b5ee-e2cbcedfe92f\nConversionCost: 1\nContent-Type: application/octet-stream\nContent-Disposition: attachment; filename=\"my_file.pdf\"; size=8475\n\n--FILE CONTENT--\n--43cf1475-ab15-4c6b-b5ee-e2cbcedfe92f--\n" }, "application/octet-stream": { "schema": { "type": "string", "format": "binary", "externalDocs": { "url": "https://www.convertapi.com/doc/content-types#applicationoctet-stream-1" } } } } }, "400": { "$ref": "#/components/responses/400" }, "401": { "$ref": "#/components/responses/401" }, "415": { "$ref": "#/components/responses/415" }, "500": { "$ref": "#/components/responses/500" }, "503": { "$ref": "#/components/responses/503" } }, "security": [ { "secret": [ ] }, { "token": [ ] }, { "jwt": [ ] } ] }, "x-ca-overview": "Stamp or watermark a PDF with the text box.", "x-ca-meta-title": null, "x-ca-meta-description": null, "x-ca-source-formats": "pdf", "x-ca-destination-formats": "pdf", "x-ca-tags": [ "watermark", "pdf" ] } }, "components": { "schemas": { "fileId": { "maxLength": 32, "minLength": 32, "type": "string", "description": "Uploaded File ID", "example": "25811safe8e61dd3f51ef00ee5f58b92" }, "error": { "type": "object", "properties": { "Code": { "type": "integer", "description": "Error message code", "format": "int32", "example": 4000 }, "Message": { "type": "string", "description": "Error message text", "example": "Parameter validation error." } }, "externalDocs": { "url": "https://www.convertapi.com/doc/response-codes" } } }, "responses": { "400": { "description": "Malformed request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error" } } } }, "401": { "description": "Authentication error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error" } } } }, "415": { "description": "File type error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error" } } } }, "500": { "description": "Conversion failure", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error" } } } }, "503": { "description": "Conversion rate limit error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/error" } } } } }, "parameters": { "fileId": { "name": "fileId", "in": "path", "description": "File ID", "required": true, "schema": { "$ref": "#/components/schemas/fileId" } }, "src": { "name": "src", "in": "path", "description": "Source file format (docx, pdf, jpg etc.)", "required": true, "schema": { "type": "string" } }, "dst": { "name": "dst", "in": "path", "description": "Destination file format (docx, pdf, jpg etc.)", "required": true, "schema": { "type": "string" } } }, "headers": { "content-disposition": { "description": "File information ([docummentation](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Disposition))", "schema": { "type": "string" } }, "file-name": { "description": "File name", "schema": { "type": "string" } }, "file-ext": { "description": "File name extension", "schema": { "type": "string" } }, "file-size": { "description": "File size", "schema": { "type": "integer" } } }, "securitySchemes": { "secret": { "type": "http", "description": "[Get `Secret`](https://www.convertapi.com/a/secret)", "scheme": "bearer" }, "token": { "type": "http", "description": "[Get `Token`](https://www.convertapi.com/a/api-tokens)", "scheme": "bearer" }, "jwt": { "type": "http", "description": "[Get `JWT`](https://www.convertapi.com/a/jwt-tokens)", "scheme": "bearer", "bearerFormat": "JWT" } } }, "tags": [ { "name": "Conversion", "description": "File Conversion API call", "externalDocs": { "description": "File Conversion related operations", "url": "https://www.convertapi.com/doc/content-types" } }, { "name": "File Server", "description": "ConvertAPI temporary file storage", "externalDocs": { "description": "File Server related operations", "url": "https://www.convertapi.com/doc/upload" } }, { "name": "User", "description": "API User", "externalDocs": { "description": "API User related operations", "url": "https://www.convertapi.com/doc/user" } } ], "externalDocs": { "description": "Find out more about ConvertAPI", "url": "https://www.convertapi.com/doc" } }