{
  "openapi": "3.0.3",
  "info": {
    "title": "PowerPoint Automation API",
    "version": "1.5.1",
    "description": "Build decks from JSON, Markdown or CSV and extract, clean, compress, merge, edit and check .pptx files. Build a deck from JSON, Markdown or CSV with themes, tables, images and speaker notes; extract text, notes, pictures and chart data; clean, compress, split, organize and merge .pptx files; find and replace text, change fonts, add slide numbers or a watermark, resize slides, check accessibility, repair damaged files, redact, and export an HTML slideshow or a reusable template. Files are processed in memory and nothing is stored. One X-API-Key header authenticates every call, and the same key works across every FreeDailyPro API. Every 4xx response is documented and none of them is billed.",
    "contact": {
      "name": "FreeDailyPro",
      "url": "https://www.freedailypro.com/developers",
      "email": "support@freedailypro.com"
    },
    "termsOfService": "https://www.freedailypro.com/terms",
    "x-logo": {
      "url": "https://www.freedailypro.com/favicon.ico"
    }
  },
  "servers": [
    {
      "url": "https://api.freedailypro.com",
      "description": "Production"
    }
  ],
  "externalDocs": {
    "description": "Developer hub, plans and MCP setup",
    "url": "https://www.freedailypro.com/developers"
  },
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  },
  "tags": [
    {
      "name": "PowerPoint Automation",
      "description": "Build decks from JSON, Markdown or CSV and extract, clean, compress, merge, edit and check .pptx files."
    }
  ],
  "paths": {
    "/v1/pptx/extract/text": {
      "post": {
        "summary": "Get the text of a PowerPoint",
        "operationId": "pptxExtractText",
        "description": "Returns the text of every slide: titles, bullets with their level, and tables, optionally with the speaker notes. format txt (default), md or json (slides with number, title, hidden, paragraphs, tables and notes). Hidden slides are skipped unless includeHidden is true. Charts and diagrams are not read. 422 when the deck has no text at all. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "format": {
                    "type": "string",
                    "description": "txt (default), md or json",
                    "enum": [
                      "txt",
                      "md",
                      "json"
                    ]
                  },
                  "includeHidden": {
                    "type": "boolean",
                    "description": "Include hidden slides. Default false."
                  },
                  "includeNotes": {
                    "type": "boolean",
                    "description": "Add each slide's speaker notes. Default false."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "format": {
                    "type": "string",
                    "description": "txt (default), md or json",
                    "enum": [
                      "txt",
                      "md",
                      "json"
                    ]
                  },
                  "includeHidden": {
                    "type": "boolean",
                    "description": "Include hidden slides. Default false."
                  },
                  "includeNotes": {
                    "type": "boolean",
                    "description": "Add each slide's speaker notes. Default false."
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, text/plain, 372 bytes.",
            "content": {
              "text/plain, text/markdown or application/json": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Slides-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides in the deck",
                "example": "6"
              },
              "X-Slides-With-Text": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides that have text",
                "example": "5"
              },
              "X-Words": {
                "schema": {
                  "type": "string"
                },
                "description": "Words counted",
                "example": "37"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/extract/notes": {
      "post": {
        "summary": "Get the speaker notes of a PowerPoint",
        "operationId": "pptxExtractNotes",
        "description": "Returns the speaker notes slide by slide as plain text, Markdown, or a Word document (.docx). Notes of hidden slides are skipped unless includeHidden is true. 422 when the deck has no speaker notes. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "format": {
                    "type": "string",
                    "description": "txt (default), md or docx",
                    "enum": [
                      "txt",
                      "md",
                      "docx"
                    ]
                  },
                  "includeHidden": {
                    "type": "boolean",
                    "description": "Include notes of hidden slides. Default false."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "format": {
                    "type": "string",
                    "description": "txt (default), md or docx",
                    "enum": [
                      "txt",
                      "md",
                      "docx"
                    ]
                  },
                  "includeHidden": {
                    "type": "boolean",
                    "description": "Include notes of hidden slides. Default false."
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, text/plain, 191 bytes.",
            "content": {
              "text/plain, text/markdown or application/vnd.openxmlformats-officedocument.wordprocessingml.document": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Slides-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides in the deck",
                "example": "6"
              },
              "X-Slides-With-Notes": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides that have notes in the result",
                "example": "3"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/extract/images": {
      "post": {
        "summary": "Extract the pictures of a PowerPoint",
        "operationId": "pptxExtractImages",
        "description": "Returns a ZIP with every picture of the deck exactly as stored (no re-encoding), named by slide, for example slide02_image-2-1.jpeg. Pictures only the slide design uses (a logo on the master) are left out unless includeTemplatePictures is true; pictures only on hidden slides are left out unless includeHidden is true. 422 when there are none. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "includeHidden": {
                    "type": "boolean",
                    "description": "Include pictures that appear only on hidden slides. Default false."
                  },
                  "includeTemplatePictures": {
                    "type": "boolean",
                    "description": "Include pictures used only by the master or layouts. Default false."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "includeHidden": {
                    "type": "boolean",
                    "description": "Include pictures that appear only on hidden slides. Default false."
                  },
                  "includeTemplatePictures": {
                    "type": "boolean",
                    "description": "Include pictures used only by the master or layouts. Default false."
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/zip, 422,271 bytes.",
            "content": {
              "application/zip": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Slides-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides in the deck",
                "example": "6"
              },
              "X-Pictures": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures in the ZIP",
                "example": "1"
              },
              "X-Pictures-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Their total size",
                "example": "422137"
              },
              "X-Picture-Files": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "slide05_image1.jpg"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/clean": {
      "post": {
        "summary": "Remove notes, comments, hidden slides and author details from a PowerPoint",
        "operationId": "pptxClean",
        "description": "Strips what you do not want to share and returns a clean .pptx: speaker notes, comments, hidden slides, author and company details with the revision list, and the stored preview picture (all on by default); document properties (title, subject, keywords) and custom properties are off by default. Slides, layouts and formatting are untouched, and parts only the removed slides used are dropped. Set an option to false to keep that thing. 422 when every slide is hidden and hiddenSlides is on. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "notes": {
                    "type": "boolean",
                    "description": "Remove speaker notes. Default true."
                  },
                  "comments": {
                    "type": "boolean",
                    "description": "Remove comments. Default true."
                  },
                  "hiddenSlides": {
                    "type": "boolean",
                    "description": "Delete slides that are hidden when presenting. Default true."
                  },
                  "authorInfo": {
                    "type": "boolean",
                    "description": "Remove author, last modified by, company, manager and the revision list. Default true."
                  },
                  "thumbnail": {
                    "type": "boolean",
                    "description": "Remove the stored preview picture. Default true."
                  },
                  "documentProperties": {
                    "type": "boolean",
                    "description": "Also clear title, subject, keywords, description and category. Default false."
                  },
                  "customProperties": {
                    "type": "boolean",
                    "description": "Also remove custom document properties. Default false."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "notes": {
                    "type": "boolean",
                    "description": "Remove speaker notes. Default true."
                  },
                  "comments": {
                    "type": "boolean",
                    "description": "Remove comments. Default true."
                  },
                  "hiddenSlides": {
                    "type": "boolean",
                    "description": "Delete slides that are hidden when presenting. Default true."
                  },
                  "authorInfo": {
                    "type": "boolean",
                    "description": "Remove author, last modified by, company, manager and the revision list. Default true."
                  },
                  "thumbnail": {
                    "type": "boolean",
                    "description": "Remove the stored preview picture. Default true."
                  },
                  "documentProperties": {
                    "type": "boolean",
                    "description": "Also clear title, subject, keywords, description and category. Default false."
                  },
                  "customProperties": {
                    "type": "boolean",
                    "description": "Also remove custom document properties. Default false."
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 456,246 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file you sent",
                "example": "467497"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "456246"
              },
              "X-Slides-Before": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides before",
                "example": "6"
              },
              "X-Slides-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides after",
                "example": "5"
              },
              "X-Notes-Pages-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Notes pages removed",
                "example": "3"
              },
              "X-Comments-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Comments removed",
                "example": "0"
              },
              "X-Hidden-Slides-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Hidden slides removed",
                "example": "1"
              },
              "X-Summary": {
                "schema": {
                  "type": "string"
                },
                "description": "Everything removed, in plain words",
                "example": "Removed 3 notes pages; No comments found; Removed 1 hidden slide; Removed author, last modified by; Removed the stored preview picture"
              },
              "X-Author-Info-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "2"
              },
              "X-Custom-Properties-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "0"
              },
              "X-Document-Properties-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "0"
              },
              "X-Thumbnail-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "1"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/compress/default": {
      "post": {
        "summary": "Compress a PowerPoint (Default level)",
        "operationId": "pptxCompressDefault",
        "description": "Re-saves the pictures at the Default level, the sharpest: up to 220 dpi at JPEG quality 82; PNG stays PNG. Pictures (JPEG, PNG, BMP) are re-saved smaller, unused slide layouts and the stored preview picture are removed, and the file is re-packed at maximum compression; text, charts, animations, audio and video stay exactly as they are, so the deck is still fully editable. Always returns a .pptx, even a deck with no pictures (the X-Note header says when it could not get smaller). Errors: 400 for a missing file or bad option; 422 with a plain reason when the file is not a readable .pptx or when the 25 second time budget runs out; 503 with Retry-After when two compressions are already running. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "removeNotes": {
                    "type": "boolean",
                    "description": "Also remove speaker notes first. Default false."
                  },
                  "removeThumbnail": {
                    "type": "boolean",
                    "description": "Remove the stored preview picture. Default true; send false to keep it."
                  },
                  "removeUnusedLayouts": {
                    "type": "boolean",
                    "description": "Remove slide layouts no slide uses, and the pictures only they carry. Default true; send false to keep them."
                  },
                  "maxDpi": {
                    "type": "number",
                    "description": "Never keep pictures sharper than this many dpi, 48 to 300, on top of the level.",
                    "minimum": 48,
                    "maximum": 300
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "removeNotes": {
                    "type": "boolean",
                    "description": "Also remove speaker notes first. Default false."
                  },
                  "removeThumbnail": {
                    "type": "boolean",
                    "description": "Remove the stored preview picture. Default true; send false to keep it."
                  },
                  "removeUnusedLayouts": {
                    "type": "boolean",
                    "description": "Remove slide layouts no slide uses, and the pictures only they carry. Default true; send false to keep them."
                  },
                  "maxDpi": {
                    "type": "number",
                    "description": "Never keep pictures sharper than this many dpi, 48 to 300, on top of the level.",
                    "minimum": 48,
                    "maximum": 300
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 329,617 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file you sent",
                "example": "467497"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "329617"
              },
              "X-Reduction-Percent": {
                "schema": {
                  "type": "string"
                },
                "description": "How much smaller, in percent",
                "example": "29.5"
              },
              "X-Level": {
                "schema": {
                  "type": "string"
                },
                "description": "The picture setting used (default, medium, strong, or t1 to t6 between and beyond them in size mode)",
                "example": "default"
              },
              "X-Pictures-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures in the deck",
                "example": "1"
              },
              "X-Pictures-Changed": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures re-saved smaller",
                "example": "1"
              },
              "X-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "What the optional removals took out"
              },
              "X-Target-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: the goal in bytes"
              },
              "X-Target-Met": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: true when the file fits the goal"
              },
              "X-Note": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: why the goal was not reached, in plain words"
              },
              "X-Picture-Bytes-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "283497"
              },
              "X-Picture-Bytes-Before": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "422137"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          },
          "503": {
            "description": "Busy: retry after the number of seconds in the Retry-After header Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/compress/medium": {
      "post": {
        "summary": "Compress a PowerPoint (Medium level)",
        "operationId": "pptxCompressMedium",
        "description": "Re-saves the pictures at the Medium level: up to 150 dpi at JPEG quality 72, and an opaque PNG photo becomes a JPEG when that is under half its size. A good size for email. Pictures (JPEG, PNG, BMP) are re-saved smaller, unused slide layouts and the stored preview picture are removed, and the file is re-packed at maximum compression; text, charts, animations, audio and video stay exactly as they are, so the deck is still fully editable. Always returns a .pptx, even a deck with no pictures (the X-Note header says when it could not get smaller). Errors: 400 for a missing file or bad option; 422 with a plain reason when the file is not a readable .pptx or when the 25 second time budget runs out; 503 with Retry-After when two compressions are already running. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "removeNotes": {
                    "type": "boolean",
                    "description": "Also remove speaker notes first. Default false."
                  },
                  "removeThumbnail": {
                    "type": "boolean",
                    "description": "Remove the stored preview picture. Default true; send false to keep it."
                  },
                  "removeUnusedLayouts": {
                    "type": "boolean",
                    "description": "Remove slide layouts no slide uses, and the pictures only they carry. Default true; send false to keep them."
                  },
                  "maxDpi": {
                    "type": "number",
                    "description": "Never keep pictures sharper than this many dpi, 48 to 300, on top of the level.",
                    "minimum": 48,
                    "maximum": 300
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "removeNotes": {
                    "type": "boolean",
                    "description": "Also remove speaker notes first. Default false."
                  },
                  "removeThumbnail": {
                    "type": "boolean",
                    "description": "Remove the stored preview picture. Default true; send false to keep it."
                  },
                  "removeUnusedLayouts": {
                    "type": "boolean",
                    "description": "Remove slide layouts no slide uses, and the pictures only they carry. Default true; send false to keep them."
                  },
                  "maxDpi": {
                    "type": "number",
                    "description": "Never keep pictures sharper than this many dpi, 48 to 300, on top of the level.",
                    "minimum": 48,
                    "maximum": 300
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 144,397 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file you sent",
                "example": "467497"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "144397"
              },
              "X-Reduction-Percent": {
                "schema": {
                  "type": "string"
                },
                "description": "How much smaller, in percent",
                "example": "69.1"
              },
              "X-Level": {
                "schema": {
                  "type": "string"
                },
                "description": "The picture setting used (default, medium, strong, or t1 to t6 between and beyond them in size mode)",
                "example": "medium"
              },
              "X-Pictures-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures in the deck",
                "example": "1"
              },
              "X-Pictures-Changed": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures re-saved smaller",
                "example": "1"
              },
              "X-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "What the optional removals took out"
              },
              "X-Target-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: the goal in bytes"
              },
              "X-Target-Met": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: true when the file fits the goal"
              },
              "X-Note": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: why the goal was not reached, in plain words"
              },
              "X-Picture-Bytes-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "98277"
              },
              "X-Picture-Bytes-Before": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "422137"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          },
          "503": {
            "description": "Busy: retry after the number of seconds in the Retry-After header Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/compress/strong": {
      "post": {
        "summary": "Compress a PowerPoint (Strong level)",
        "operationId": "pptxCompressStrong",
        "description": "Re-saves the pictures at the Strong level, the smallest of the three: up to 110 dpi at JPEG quality 58. Fine on screen, soft in print. Pictures (JPEG, PNG, BMP) are re-saved smaller, unused slide layouts and the stored preview picture are removed, and the file is re-packed at maximum compression; text, charts, animations, audio and video stay exactly as they are, so the deck is still fully editable. Always returns a .pptx, even a deck with no pictures (the X-Note header says when it could not get smaller). Errors: 400 for a missing file or bad option; 422 with a plain reason when the file is not a readable .pptx or when the 25 second time budget runs out; 503 with Retry-After when two compressions are already running. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "removeNotes": {
                    "type": "boolean",
                    "description": "Also remove speaker notes first. Default false."
                  },
                  "removeThumbnail": {
                    "type": "boolean",
                    "description": "Remove the stored preview picture. Default true; send false to keep it."
                  },
                  "removeUnusedLayouts": {
                    "type": "boolean",
                    "description": "Remove slide layouts no slide uses, and the pictures only they carry. Default true; send false to keep them."
                  },
                  "maxDpi": {
                    "type": "number",
                    "description": "Never keep pictures sharper than this many dpi, 48 to 300, on top of the level.",
                    "minimum": 48,
                    "maximum": 300
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "removeNotes": {
                    "type": "boolean",
                    "description": "Also remove speaker notes first. Default false."
                  },
                  "removeThumbnail": {
                    "type": "boolean",
                    "description": "Remove the stored preview picture. Default true; send false to keep it."
                  },
                  "removeUnusedLayouts": {
                    "type": "boolean",
                    "description": "Remove slide layouts no slide uses, and the pictures only they carry. Default true; send false to keep them."
                  },
                  "maxDpi": {
                    "type": "number",
                    "description": "Never keep pictures sharper than this many dpi, 48 to 300, on top of the level.",
                    "minimum": 48,
                    "maximum": 300
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 90,086 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file you sent",
                "example": "467497"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "90086"
              },
              "X-Reduction-Percent": {
                "schema": {
                  "type": "string"
                },
                "description": "How much smaller, in percent",
                "example": "80.7"
              },
              "X-Level": {
                "schema": {
                  "type": "string"
                },
                "description": "The picture setting used (default, medium, strong, or t1 to t6 between and beyond them in size mode)",
                "example": "strong"
              },
              "X-Pictures-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures in the deck",
                "example": "1"
              },
              "X-Pictures-Changed": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures re-saved smaller",
                "example": "1"
              },
              "X-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "What the optional removals took out"
              },
              "X-Target-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: the goal in bytes"
              },
              "X-Target-Met": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: true when the file fits the goal"
              },
              "X-Note": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: why the goal was not reached, in plain words"
              },
              "X-Picture-Bytes-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "43966"
              },
              "X-Picture-Bytes-Before": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "422137"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          },
          "503": {
            "description": "Busy: retry after the number of seconds in the Retry-After header Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/compress/size": {
      "post": {
        "summary": "Compress a PowerPoint to a size",
        "operationId": "pptxCompressSize",
        "description": "Runs nine picture settings from the sharpest to the coarsest and returns the sharpest result that fits targetSize (X-Target-Met: true). If even the coarsest does not fit you get the smallest file it can make with X-Target-Met: false and X-Note in plain words. A deck already at or under the goal comes back unchanged (X-Level: none). Pictures (JPEG, PNG, BMP) are re-saved smaller, unused slide layouts and the stored preview picture are removed, and the file is re-packed at maximum compression; text, charts, animations, audio and video stay exactly as they are, so the deck is still fully editable. Always returns a .pptx, even a deck with no pictures (the X-Note header says when it could not get smaller). Errors: 400 for a missing file or bad option; 422 with a plain reason when the file is not a readable .pptx or when the 25 second time budget runs out; 503 with Retry-After when two compressions are already running. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "removeNotes": {
                    "type": "boolean",
                    "description": "Also remove speaker notes first. Default false."
                  },
                  "removeThumbnail": {
                    "type": "boolean",
                    "description": "Remove the stored preview picture. Default true; send false to keep it."
                  },
                  "removeUnusedLayouts": {
                    "type": "boolean",
                    "description": "Remove slide layouts no slide uses, and the pictures only they carry. Default true; send false to keep them."
                  },
                  "maxDpi": {
                    "type": "number",
                    "description": "Never keep pictures sharper than this many dpi, 48 to 300, on top of the level.",
                    "minimum": 48,
                    "maximum": 300
                  },
                  "targetSize": {
                    "type": "string",
                    "description": "The size to reach: bytes, or text such as 10MB or 800KB (at least 1 KB).",
                    "example": "10MB"
                  }
                },
                "required": [
                  "file",
                  "targetSize"
                ]
              },
              "example": {
                "file": "sample.pptx",
                "targetSize": "10MB"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "removeNotes": {
                    "type": "boolean",
                    "description": "Also remove speaker notes first. Default false."
                  },
                  "removeThumbnail": {
                    "type": "boolean",
                    "description": "Remove the stored preview picture. Default true; send false to keep it."
                  },
                  "removeUnusedLayouts": {
                    "type": "boolean",
                    "description": "Remove slide layouts no slide uses, and the pictures only they carry. Default true; send false to keep them."
                  },
                  "maxDpi": {
                    "type": "number",
                    "description": "Never keep pictures sharper than this many dpi, 48 to 300, on top of the level.",
                    "minimum": 48,
                    "maximum": 300
                  },
                  "targetSize": {
                    "type": "string",
                    "description": "The size to reach: bytes, or text such as 10MB or 800KB (at least 1 KB).",
                    "example": "10MB"
                  }
                },
                "required": [
                  "fileBase64",
                  "targetSize"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 90,086 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file you sent",
                "example": "467497"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "90086"
              },
              "X-Reduction-Percent": {
                "schema": {
                  "type": "string"
                },
                "description": "How much smaller, in percent",
                "example": "80.7"
              },
              "X-Level": {
                "schema": {
                  "type": "string"
                },
                "description": "The picture setting used (default, medium, strong, or t1 to t6 between and beyond them in size mode)",
                "example": "strong"
              },
              "X-Pictures-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures in the deck",
                "example": "1"
              },
              "X-Pictures-Changed": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures re-saved smaller",
                "example": "1"
              },
              "X-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "What the optional removals took out"
              },
              "X-Target-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: the goal in bytes",
                "example": "102400"
              },
              "X-Target-Met": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: true when the file fits the goal",
                "example": "true"
              },
              "X-Note": {
                "schema": {
                  "type": "string"
                },
                "description": "size mode: why the goal was not reached, in plain words"
              },
              "X-Picture-Bytes-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "43966"
              },
              "X-Picture-Bytes-Before": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "422137"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          },
          "503": {
            "description": "Busy: retry after the number of seconds in the Retry-After header Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/split": {
      "post": {
        "summary": "Split a PowerPoint into several presentations",
        "operationId": "pptxSplit",
        "description": "Returns ONE ZIP of .pptx files, each a complete editable deck that keeps its own slides' notes, pictures, charts and tables, named like talk_slide-01.pptx or talk_slides-1-3.pptx. mode: each (one file per slide; the default), every (every N slides, give every) or range (ranges such as 1-3,5,8-: one file per range, or one file with all of them when rangesAsFiles is false). At most 100 files; 25 second time budget. Errors: 400 for a missing option or a slide number that does not exist (the message says how many slides the deck has); 422 when the file is not a readable .pptx or the time budget runs out; 503 when busy. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "mode": {
                    "type": "string",
                    "description": "each, every or range. Default: range when ranges is sent, every when every is sent, else each.",
                    "enum": [
                      "each",
                      "every",
                      "range"
                    ]
                  },
                  "ranges": {
                    "type": "string",
                    "description": "range mode: comma-separated slides or ranges, for example 1-3,5,8- (8- means 8 to the end)",
                    "example": "1-3,5,8-"
                  },
                  "rangesAsFiles": {
                    "type": "boolean",
                    "description": "range mode: true (default) = one file per range; false = one file with all chosen slides."
                  },
                  "every": {
                    "type": "number",
                    "description": "every mode: slides per file, for example 5",
                    "minimum": 1
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "mode": {
                    "type": "string",
                    "description": "each, every or range. Default: range when ranges is sent, every when every is sent, else each.",
                    "enum": [
                      "each",
                      "every",
                      "range"
                    ]
                  },
                  "ranges": {
                    "type": "string",
                    "description": "range mode: comma-separated slides or ranges, for example 1-3,5,8- (8- means 8 to the end)",
                    "example": "1-3,5,8-"
                  },
                  "rangesAsFiles": {
                    "type": "boolean",
                    "description": "range mode: true (default) = one file per range; false = one file with all chosen slides."
                  },
                  "every": {
                    "type": "number",
                    "description": "every mode: slides per file, for example 5",
                    "minimum": 1
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/zip, 617,849 bytes.",
            "content": {
              "application/zip": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Slides-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides in the deck",
                "example": "6"
              },
              "X-Parts": {
                "schema": {
                  "type": "string"
                },
                "description": "Files in the ZIP",
                "example": "6"
              },
              "X-Files": {
                "schema": {
                  "type": "string"
                },
                "description": "Their names, comma separated",
                "example": "sample_slide-01.pptx,sample_slide-02.pptx,sample_slide-03.pptx,sample_slide-04.pptx,sample_slide-05.pptx,sample_slide-06.pptx"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the ZIP",
                "example": "617849"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          },
          "503": {
            "description": "Busy: retry after the number of seconds in the Retry-After header Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/organize": {
      "post": {
        "summary": "Reorder, delete and duplicate the slides of a PowerPoint",
        "operationId": "pptxOrganize",
        "description": "Returns a new editable .pptx; the slide master, layouts and theme stay as they were and every slide keeps its notes, pictures, charts and tables. All slide numbers are 1-based and refer to the ORIGINAL deck. order is the final sequence, for example 3,1,2 (a number twice makes a copy); remove deletes slides; duplicate puts a copy right after the original; removeHidden deletes every hidden slide. Order is applied first, then remove, then duplicate. 400 when a number does not exist, when every slide would be removed, or when nothing was asked. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "order": {
                    "type": "string",
                    "description": "Final order as slide numbers: a JSON array or comma-separated, for example [3,1,2] or 3,1,2"
                  },
                  "remove": {
                    "type": "string",
                    "description": "Slides to delete, for example [2,4] or 2,4"
                  },
                  "duplicate": {
                    "type": "string",
                    "description": "Slides to copy, for example [1] or 1"
                  },
                  "removeHidden": {
                    "type": "boolean",
                    "description": "Delete every slide that is hidden when presenting."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "order": {
                    "type": "string",
                    "description": "Final order as slide numbers: a JSON array or comma-separated, for example [3,1,2] or 3,1,2"
                  },
                  "remove": {
                    "type": "string",
                    "description": "Slides to delete, for example [2,4] or 2,4"
                  },
                  "duplicate": {
                    "type": "string",
                    "description": "Slides to copy, for example [1] or 1"
                  },
                  "removeHidden": {
                    "type": "boolean",
                    "description": "Delete every slide that is hidden when presenting."
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 33,250 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Slides-Before": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides before",
                "example": "6"
              },
              "X-Slides-After": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides after",
                "example": "1"
              },
              "X-Slides-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Original slides left out",
                "example": "5"
              },
              "X-Slides-Copied": {
                "schema": {
                  "type": "string"
                },
                "description": "Extra copies made",
                "example": "0"
              },
              "X-Final-Order": {
                "schema": {
                  "type": "string"
                },
                "description": "The slide numbers of the result, in order",
                "example": "1"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "33250"
              },
              "X-Reordered": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "false"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/merge": {
      "post": {
        "summary": "Merge PowerPoint presentations into one",
        "operationId": "pptxMerge",
        "description": "Joins two to ten presentations in the order sent into one editable .pptx (100 MB in all). Each deck keeps its own master, layouts and theme (several masters in one file), so slides look as they did; useFirstDesign=true puts later decks on the first deck's layouts when the layout names match, and is refused with the reason when they do not. Every deck must have the same slide size: a mismatch returns 422 with a plain message naming the decks and their sizes in inches (and the fields problems and slideSizes), so nothing is stretched. Comments of the second and later decks are left out. Errors: 400 for fewer than two files, more than ten or too much data; 422 for a size mismatch or a file that is not a readable .pptx (the message names it). The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "files": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "format": "binary"
                    },
                    "description": "Two to ten presentations (repeat the field). Slides join in the order sent."
                  },
                  "useFirstDesign": {
                    "type": "boolean",
                    "description": "Put every later deck on the first deck's layouts. Default false."
                  }
                },
                "required": [
                  "files"
                ]
              },
              "example": {
                "files": [
                  "a.pptx",
                  "b.pptx"
                ]
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "files": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "description": "File name, used in messages"
                        },
                        "base64": {
                          "type": "string",
                          "description": "The .pptx, base64 encoded"
                        }
                      },
                      "required": [
                        "base64"
                      ]
                    }
                  },
                  "useFirstDesign": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "files"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 926,279 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Slides": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides in the result",
                "example": "12"
              },
              "X-Decks": {
                "schema": {
                  "type": "string"
                },
                "description": "Presentations merged",
                "example": "2"
              },
              "X-Per-Deck": {
                "schema": {
                  "type": "string"
                },
                "description": "name:slides for each deck",
                "example": "sample.pptx:6,sample.pptx:6"
              },
              "X-Masters": {
                "schema": {
                  "type": "string"
                },
                "description": "Slide masters in the result",
                "example": "2"
              },
              "X-Comments-Left-Out": {
                "schema": {
                  "type": "string"
                },
                "description": "Comments not carried over",
                "example": "0"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "926279"
              },
              "X-Notes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "Each file keeps its own design, so the merged file has 2 slide masters. Slides from different designs will look different.; Notes pages of the later files use the first file's notes master."
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/from-markdown": {
      "post": {
        "summary": "Make a PowerPoint from Markdown",
        "operationId": "pptxFromMarkdown",
        "description": "Turns Markdown (or an indented outline) into an editable .pptx with real title and body placeholders, so Outline view, the slide master and accessibility checks work. # Title makes the title slide (a short line under it is the subtitle), ## Heading a new slide, ### Heading a bold sub-heading, - item or 1. item bullets (indent two spaces for sub-bullets), | a | b | tables, Note: text speaker notes, --- ends a slide; **bold**, *italic*, `code` and [links](https://example.com) work. Pictures given by web address are never fetched (X-Warnings says so); use /v1/pptx/from-json to add pictures. mode outline reads a plain indented outline (first line = deck title). Send JSON {\"markdown\": \"...\"} or multipart with a markdown field or a .md file. 400 for empty text, an unknown theme or a bad brand colour. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "markdown": {
                    "type": "string",
                    "description": "The deck as Markdown (up to 1,000,000 characters). Or send a .md file in the 'file' field."
                  },
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "A Markdown file, instead of markdown. Up to 10 MB."
                  },
                  "mode": {
                    "type": "string",
                    "description": "markdown (default) or outline",
                    "enum": [
                      "markdown",
                      "outline"
                    ]
                  },
                  "theme": {
                    "type": "string",
                    "description": "clean (default), dark, corporate, warm or minimal",
                    "enum": [
                      "clean",
                      "dark",
                      "corporate",
                      "warm",
                      "minimal"
                    ]
                  },
                  "brand": {
                    "type": "string",
                    "description": "JSON object {\"color\":\"#0b6e4f\",\"headingFont\":\"Georgia\",\"bodyFont\":\"Calibri\",\"dark\":false}; replaces theme"
                  }
                },
                "required": []
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "markdown": {
                    "type": "string",
                    "description": "The deck as Markdown"
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "markdown",
                      "outline"
                    ]
                  },
                  "theme": {
                    "type": "string",
                    "enum": [
                      "clean",
                      "dark",
                      "corporate",
                      "warm",
                      "minimal"
                    ]
                  },
                  "brand": {
                    "type": "object",
                    "properties": {
                      "color": {
                        "type": "string",
                        "example": "#0b6e4f"
                      },
                      "headingFont": {
                        "type": "string"
                      },
                      "bodyFont": {
                        "type": "string"
                      },
                      "dark": {
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "color"
                    ]
                  }
                },
                "required": [
                  "markdown"
                ]
              },
              "example": {
                "markdown": "# Quarterly Review\nQ3 results and next steps\nNote: Welcome everyone.\n\n## What went well\n- Revenue up **12%**\n  - One new customer in healthcare\n- Support response time under 2 hours\n\n## Numbers\n| Metric | Q2 | Q3 |\n| --- | --- | --- |\n| Revenue | $1.2M | $1.34M |\n\n---\n\n## Next steps\n1. Hire a customer success lead\n2. Launch the new pricing page",
                "theme": "clean"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 84,174 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Slides": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides made",
                "example": "4"
              },
              "X-Theme": {
                "schema": {
                  "type": "string"
                },
                "description": "The theme used",
                "example": "clean"
              },
              "X-Warning-Count": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of warnings",
                "example": "0"
              },
              "X-Warnings": {
                "schema": {
                  "type": "string"
                },
                "description": "Warnings joined with ' | ' (pictures not added, slides with too much text)"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "84174"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/from-json": {
      "post": {
        "summary": "Make a PowerPoint from JSON slides",
        "operationId": "pptxFromJson",
        "description": "Builds an editable .pptx from a JSON description of the slides: the strongest way for software and AI agents to produce a real deck. Body: {\"title\"?, \"theme\"?, \"brand\"?, \"slides\": [...]}. Each slide: title (text), subtitle, layout (\"title\" = cover, \"content\"), bullets (strings, or {\"text\", \"bullets\": [...]} for sub-bullets, five levels), numbered (true for 1. 2. 3.), text (a paragraph or a list of paragraphs, shown above the bullets), table ({\"header\": [...], \"rows\": [[...]]} or just rows; cells text, number, boolean or null), image ({\"data\": base64 or data: URI of a PNG, JPEG or GIF, \"alt\": \"what it shows\"}) and notes (speaker notes). A slide with only a title (and subtitle) is a cover when it is first or has a subtitle. With an image the text and table sit on the left and the picture on the right, keeping its shape; an image alone is centred. bullets, text and subtitle accept **bold**, *italic*, `code` and [links](https://example.com); titles and table cells are plain text. Pictures are never fetched from a web address: send base64, with alt text (X-Warnings reminds you when it is missing, and when a slide has no title or a table is too long for one slide). Limits: 200 slides, 40 bullets and 5000 characters per text, tables up to 60 rows and 12 columns (comfortable up to 14 rows), pictures 8 MB each and 24 MB in all. Themes: clean, dark, corporate, warm, minimal, or brand {\"color\": \"#0b6e4f\", \"headingFont\": \"Georgia\", \"bodyFont\": \"Calibri\", \"dark\": false}. Errors are 400 and name the field, for example \"slides[2].bullets[1] must be text or an object like {\"text\": \"...\", \"bullets\": [...]}.\" or \"slides[0] has an unknown field \"bulets\". Allowed fields: ...\". The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "description": "Deck title (the file's title property). Default: the first slide's title."
                  },
                  "theme": {
                    "type": "string",
                    "enum": [
                      "clean",
                      "dark",
                      "corporate",
                      "warm",
                      "minimal"
                    ],
                    "description": "Default clean. Ignored when brand is given."
                  },
                  "brand": {
                    "type": "object",
                    "description": "A theme made from a brand colour and fonts",
                    "properties": {
                      "color": {
                        "type": "string",
                        "example": "#0b6e4f"
                      },
                      "headingFont": {
                        "type": "string",
                        "example": "Georgia"
                      },
                      "bodyFont": {
                        "type": "string",
                        "example": "Calibri"
                      },
                      "dark": {
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "color"
                    ]
                  },
                  "slides": {
                    "type": "array",
                    "minItems": 1,
                    "maxItems": 200,
                    "items": {
                      "type": "object",
                      "description": "One slide. Unknown fields are rejected.",
                      "properties": {
                        "title": {
                          "type": "string"
                        },
                        "subtitle": {
                          "type": "string"
                        },
                        "layout": {
                          "type": "string",
                          "enum": [
                            "title",
                            "content"
                          ]
                        },
                        "bullets": {
                          "type": "array",
                          "description": "Strings, or {text, bullets: [...]} objects for sub-bullets",
                          "items": {
                            "oneOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "object",
                                "properties": {
                                  "text": {
                                    "type": "string"
                                  },
                                  "bullets": {
                                    "type": "array",
                                    "items": {}
                                  }
                                },
                                "required": [
                                  "text"
                                ]
                              }
                            ]
                          }
                        },
                        "numbered": {
                          "type": "boolean"
                        },
                        "text": {
                          "oneOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            }
                          ]
                        },
                        "table": {
                          "type": "object",
                          "properties": {
                            "header": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            "rows": {
                              "type": "array",
                              "items": {
                                "type": "array",
                                "items": {
                                  "oneOf": [
                                    {
                                      "type": "string"
                                    },
                                    {
                                      "type": "number"
                                    },
                                    {
                                      "type": "boolean"
                                    }
                                  ]
                                }
                              }
                            }
                          },
                          "required": [
                            "rows"
                          ]
                        },
                        "image": {
                          "type": "object",
                          "properties": {
                            "data": {
                              "type": "string",
                              "description": "Base64 or data: URI of a PNG, JPEG or GIF"
                            },
                            "alt": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "data"
                          ]
                        },
                        "notes": {
                          "type": "string",
                          "description": "Speaker notes"
                        }
                      }
                    }
                  }
                },
                "required": [
                  "slides"
                ]
              },
              "example": {
                "title": "Q3 Review",
                "theme": "corporate",
                "slides": [
                  {
                    "title": "Q3 Review",
                    "subtitle": "Revenue and next steps"
                  },
                  {
                    "title": "Highlights",
                    "bullets": [
                      "Revenue up **12%** on last quarter",
                      {
                        "text": "Two new customers",
                        "bullets": [
                          "Healthcare",
                          "Logistics"
                        ]
                      },
                      "Support response time under 2 hours"
                    ],
                    "notes": "Mention the healthcare win by name."
                  },
                  {
                    "title": "Plan",
                    "numbered": true,
                    "bullets": [
                      "Hire a customer success lead",
                      "Launch the new pricing page",
                      "Review the plan in [our planning doc](https://example.com/plan)"
                    ]
                  },
                  {
                    "title": "Numbers at a glance",
                    "table": {
                      "header": [
                        "Metric",
                        "Q2",
                        "Q3"
                      ],
                      "rows": [
                        [
                          "Revenue",
                          "$1.2M",
                          "$1.34M"
                        ],
                        [
                          "New customers",
                          5,
                          7
                        ],
                        [
                          "Support tickets",
                          410,
                          380
                        ]
                      ]
                    }
                  },
                  {
                    "title": "The dashboard",
                    "text": "Live numbers for every team.",
                    "bullets": [
                      "Updated hourly",
                      "Exports to CSV"
                    ],
                    "image": {
                      "data": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==",
                      "alt": "Screenshot of the dashboard"
                    }
                  }
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 104,513 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Slides": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides made",
                "example": "5"
              },
              "X-Theme": {
                "schema": {
                  "type": "string"
                },
                "description": "The theme used",
                "example": "corporate"
              },
              "X-Warning-Count": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of warnings",
                "example": "0"
              },
              "X-Warnings": {
                "schema": {
                  "type": "string"
                },
                "description": "Warnings joined with ' | '"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "104513"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/from-csv": {
      "post": {
        "summary": "Make a PowerPoint from a CSV file",
        "operationId": "pptxFromCsv",
        "description": "Turns a CSV file into table slides: a cover with the title and the size of the table, then the header and up to rowsPerSlide rows (default 12, max 40) on each slide, titled \"Title (1 of 3)\", with the row range in the speaker notes. The first row holds the column names unless header is false. The delimiter (comma, semicolon or tab) is found from the first line unless you send delimiter. Cells are kept as plain text. At most 12 columns and 200 slides. Send JSON {\"csv\": \"...\"} or multipart with a CSV file (10 MB). 400 for an empty CSV, too many columns or rows, or a bad option. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The CSV file (or send the text in the csv field). Up to 10 MB."
                  },
                  "csv": {
                    "type": "string",
                    "description": "The CSV text, instead of a file"
                  },
                  "title": {
                    "type": "string",
                    "description": "Deck and slide title. Default Data."
                  },
                  "rowsPerSlide": {
                    "type": "number",
                    "description": "Data rows per slide, 1 to 40. Default 12.",
                    "minimum": 1,
                    "maximum": 40
                  },
                  "header": {
                    "type": "boolean",
                    "description": "The first row holds column names. Default true."
                  },
                  "titleSlide": {
                    "type": "boolean",
                    "description": "Add a cover slide. Default true."
                  },
                  "delimiter": {
                    "type": "string",
                    "description": "One character, or tab. Default: detected."
                  },
                  "theme": {
                    "type": "string",
                    "description": "clean (default), dark, corporate, warm or minimal",
                    "enum": [
                      "clean",
                      "dark",
                      "corporate",
                      "warm",
                      "minimal"
                    ]
                  },
                  "brand": {
                    "type": "string",
                    "description": "JSON object {\"color\":\"#0b6e4f\"}; replaces theme"
                  }
                },
                "required": []
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "csv": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "rowsPerSlide": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 40
                  },
                  "header": {
                    "type": "boolean"
                  },
                  "titleSlide": {
                    "type": "boolean"
                  },
                  "delimiter": {
                    "type": "string"
                  },
                  "theme": {
                    "type": "string",
                    "enum": [
                      "clean",
                      "dark",
                      "corporate",
                      "warm",
                      "minimal"
                    ]
                  },
                  "brand": {
                    "type": "object",
                    "properties": {
                      "color": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "color"
                    ]
                  }
                },
                "required": [
                  "csv"
                ]
              },
              "example": {
                "csv": "Region,Q2,Q3\nNorth,120,135\nSouth,98,101\nEast,143,160\nWest,87,92",
                "title": "Sales by region",
                "rowsPerSlide": 12,
                "theme": "corporate"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 83,777 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Slides": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides made",
                "example": "2"
              },
              "X-Rows": {
                "schema": {
                  "type": "string"
                },
                "description": "Data rows",
                "example": "4"
              },
              "X-Delimiter": {
                "schema": {
                  "type": "string"
                },
                "description": "The delimiter used",
                "example": ","
              },
              "X-Theme": {
                "schema": {
                  "type": "string"
                },
                "description": "The theme used",
                "example": "corporate"
              },
              "X-Warnings": {
                "schema": {
                  "type": "string"
                },
                "description": "Warnings joined with ' | '"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "83777"
              },
              "X-Warning-Count": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "0"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/find-replace": {
      "post": {
        "summary": "Find and replace text in a PowerPoint",
        "operationId": "pptxFindReplace",
        "description": "Replaces text on every slide of a .pptx and returns the edited deck. A match is found even when PowerPoint split the words into several runs; the formatting of the first run is kept. Speaker notes are searched too (includeNotes, default true); the slide master and layouts only when includeTemplate is true. Slides in skipSlides are left alone. 422 when nothing matches, so a misspelling is noticed. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "find": {
                    "type": "string",
                    "description": "The text to look for (up to 500 characters)",
                    "example": "Acme Ltd"
                  },
                  "replace": {
                    "type": "string",
                    "description": "The new text (up to 5000 characters). Empty removes the match.",
                    "example": "Globex Inc"
                  },
                  "matchCase": {
                    "type": "boolean",
                    "description": "Match upper and lower case exactly. Default false."
                  },
                  "wholeWord": {
                    "type": "boolean",
                    "description": "Match whole words only. Default false."
                  },
                  "includeNotes": {
                    "type": "boolean",
                    "description": "Also change speaker notes. Default true."
                  },
                  "includeTemplate": {
                    "type": "boolean",
                    "description": "Also change the slide master and layouts. Default false."
                  },
                  "skipSlides": {
                    "type": "string",
                    "description": "Slides to leave alone, for example [2,4] or 2,4"
                  }
                },
                "required": [
                  "file",
                  "find"
                ]
              },
              "example": {
                "file": "sample.pptx",
                "find": "Acme Ltd"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "find": {
                    "type": "string",
                    "description": "The text to look for (up to 500 characters)",
                    "example": "Acme Ltd"
                  },
                  "replace": {
                    "type": "string",
                    "description": "The new text (up to 5000 characters). Empty removes the match.",
                    "example": "Globex Inc"
                  },
                  "matchCase": {
                    "type": "boolean",
                    "description": "Match upper and lower case exactly. Default false."
                  },
                  "wholeWord": {
                    "type": "boolean",
                    "description": "Match whole words only. Default false."
                  },
                  "includeNotes": {
                    "type": "boolean",
                    "description": "Also change speaker notes. Default true."
                  },
                  "includeTemplate": {
                    "type": "boolean",
                    "description": "Also change the slide master and layouts. Default false."
                  },
                  "skipSlides": {
                    "type": "string",
                    "description": "Slides to leave alone, for example [2,4] or 2,4"
                  }
                },
                "required": [
                  "fileBase64",
                  "find"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 467,932 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Replaced": {
                "schema": {
                  "type": "string"
                },
                "description": "Matches replaced",
                "example": "7"
              },
              "X-Slides-With-Matches": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides that held a match",
                "example": "6"
              },
              "X-Matches-On-Master-And-Layouts": {
                "schema": {
                  "type": "string"
                },
                "description": "Matches found on the master and layouts",
                "example": "0"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file you sent",
                "example": "467497"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "467932"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/fonts": {
      "post": {
        "summary": "List the fonts a PowerPoint uses",
        "operationId": "pptxFonts",
        "description": "Returns JSON {\"fonts\": [...]}: each font's name, how many places use it, the slides that use it, whether the master, layouts or theme use it, whether it is the theme's heading or body font, and whether a copy is embedded. Use it before /v1/pptx/replace-fonts. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "fonts": [
                    {
                      "name": "Calibri",
                      "count": 4,
                      "slides": [],
                      "inTemplate": true,
                      "kinds": [
                        "latin"
                      ],
                      "embedded": false,
                      "themeRole": "headings"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/replace-fonts": {
      "post": {
        "summary": "Replace fonts in a PowerPoint",
        "operationId": "pptxReplaceFonts",
        "description": "Swaps fonts everywhere they are named: slides, notes, layouts, masters, the theme's heading and body fonts, charts and SmartArt. mapping is a JSON object {\"Old font\": \"New font\"}. Embedded copies of replaced fonts are removed. Text is not resized, so a wider font can make a line wrap. 422 when none of the named fonts is used. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "mapping": {
                    "type": "string",
                    "description": "JSON object mapping old font names to new ones",
                    "example": "{\"Calibri\":\"Arial\"}"
                  }
                },
                "required": [
                  "file",
                  "mapping"
                ]
              },
              "example": {
                "file": "sample.pptx",
                "mapping": "{\"Calibri\":\"Arial\"}"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "mapping": {
                    "type": "string",
                    "description": "JSON object mapping old font names to new ones",
                    "example": "{\"Calibri\":\"Arial\"}"
                  }
                },
                "required": [
                  "fileBase64",
                  "mapping"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 467,815 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Places-Changed": {
                "schema": {
                  "type": "string"
                },
                "description": "Places changed",
                "example": "4"
              },
              "X-Fonts-Changed": {
                "schema": {
                  "type": "string"
                },
                "description": "Fonts swapped",
                "example": "1"
              },
              "X-Embedded-Fonts-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Embedded fonts removed",
                "example": "0"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "467815"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "467497"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/slide-numbers": {
      "post": {
        "summary": "Add or remove slide numbers in a PowerPoint",
        "operationId": "pptxSlideNumbers",
        "description": "Adds a real slide-number field to every slide (so the number follows when slides move), or removes the numbers the slides themselves carry (mode remove). Slides that already have a number are left alone. The total in format of-total is plain text. 422 when every slide already has a number, or when there is nothing to remove. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "mode": {
                    "type": "string",
                    "description": "add (default) or remove",
                    "enum": [
                      "add",
                      "remove"
                    ]
                  },
                  "position": {
                    "type": "string",
                    "description": "bottom-right (default), bottom-center, bottom-left or top-right",
                    "enum": [
                      "bottom-right",
                      "bottom-center",
                      "bottom-left",
                      "top-right"
                    ]
                  },
                  "format": {
                    "type": "string",
                    "description": "number (3), slide-number (Slide 3) or of-total (3 / 12). Default number.",
                    "enum": [
                      "number",
                      "slide-number",
                      "of-total"
                    ]
                  },
                  "startAt": {
                    "type": "number",
                    "description": "Number of the first slide, 0 to 9999. Default 1; 0 makes the second slide 1.",
                    "minimum": 0,
                    "maximum": 9999
                  },
                  "skipFirst": {
                    "type": "boolean",
                    "description": "Leave the first slide without a number."
                  },
                  "size": {
                    "type": "number",
                    "description": "Points, 8 to 40. Default 12.",
                    "minimum": 8,
                    "maximum": 40
                  },
                  "color": {
                    "type": "string",
                    "description": "Hex colour such as 595959"
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "mode": {
                    "type": "string",
                    "description": "add (default) or remove",
                    "enum": [
                      "add",
                      "remove"
                    ]
                  },
                  "position": {
                    "type": "string",
                    "description": "bottom-right (default), bottom-center, bottom-left or top-right",
                    "enum": [
                      "bottom-right",
                      "bottom-center",
                      "bottom-left",
                      "top-right"
                    ]
                  },
                  "format": {
                    "type": "string",
                    "description": "number (3), slide-number (Slide 3) or of-total (3 / 12). Default number.",
                    "enum": [
                      "number",
                      "slide-number",
                      "of-total"
                    ]
                  },
                  "startAt": {
                    "type": "number",
                    "description": "Number of the first slide, 0 to 9999. Default 1; 0 makes the second slide 1.",
                    "minimum": 0,
                    "maximum": 9999
                  },
                  "skipFirst": {
                    "type": "boolean",
                    "description": "Leave the first slide without a number."
                  },
                  "size": {
                    "type": "number",
                    "description": "Points, 8 to 40. Default 12.",
                    "minimum": 8,
                    "maximum": 40
                  },
                  "color": {
                    "type": "string",
                    "description": "Hex colour such as 595959"
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 469,102 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Added": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides numbered",
                "example": "6"
              },
              "X-Already-Numbered": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides that already had a number",
                "example": "0"
              },
              "X-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Numbers removed (remove mode)"
              },
              "X-First-Number": {
                "schema": {
                  "type": "string"
                },
                "description": "The first number shown",
                "example": "1"
              },
              "X-Last-Number": {
                "schema": {
                  "type": "string"
                },
                "description": "The last number shown",
                "example": "6"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "469102"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "467497"
              },
              "X-Skipped-First": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "false"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/watermark": {
      "post": {
        "summary": "Add or remove a watermark in a PowerPoint",
        "operationId": "pptxWatermark",
        "description": "Stamps a text watermark (such as DRAFT or CONFIDENTIAL) or a PNG/JPEG picture on the slides, behind the content by default, or removes the watermarks this endpoint made (mode remove). Send text, or a picture (multipart file field 'picture', or JSON pictureBase64). 422 when there is no watermark to remove. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "mode": {
                    "type": "string",
                    "description": "add (default) or remove",
                    "enum": [
                      "add",
                      "remove"
                    ]
                  },
                  "text": {
                    "type": "string",
                    "description": "The watermark words (up to 80 characters)",
                    "example": "DRAFT"
                  },
                  "picture": {
                    "type": "string",
                    "format": "binary",
                    "description": "A PNG or JPEG, instead of text. Up to 10 MB."
                  },
                  "pictureBase64": {
                    "type": "string",
                    "description": "A PNG or JPEG as base64, instead of text (JSON requests)"
                  },
                  "color": {
                    "type": "string",
                    "description": "Text colour, hex. Default 808080."
                  },
                  "opacity": {
                    "type": "number",
                    "description": "Percent opaque, 5 to 100. Default 30.",
                    "minimum": 5,
                    "maximum": 100
                  },
                  "size": {
                    "type": "string",
                    "description": "Points (8 to 400) or auto. Default auto."
                  },
                  "rotation": {
                    "type": "number",
                    "description": "Degrees, -90 to 90; negative rises to the right. Default -45 for text, 0 for a picture.",
                    "minimum": -90,
                    "maximum": 90
                  },
                  "font": {
                    "type": "string",
                    "description": "Default Arial"
                  },
                  "bold": {
                    "type": "boolean",
                    "description": "Default true"
                  },
                  "widthPercent": {
                    "type": "number",
                    "description": "Picture width as a percent of the slide, 5 to 100. Default 50.",
                    "minimum": 5,
                    "maximum": 100
                  },
                  "place": {
                    "type": "string",
                    "description": "center (default), top, bottom, top-left, top-right, bottom-left or bottom-right",
                    "enum": [
                      "center",
                      "top",
                      "bottom",
                      "top-left",
                      "top-right",
                      "bottom-left",
                      "bottom-right"
                    ]
                  },
                  "layer": {
                    "type": "string",
                    "description": "behind (default) or front",
                    "enum": [
                      "behind",
                      "front"
                    ]
                  },
                  "slides": {
                    "type": "string",
                    "description": "Slides to mark, for example [1,3] or 1,3. Default all."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx",
                "picture": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "mode": {
                    "type": "string",
                    "description": "add (default) or remove",
                    "enum": [
                      "add",
                      "remove"
                    ]
                  },
                  "text": {
                    "type": "string",
                    "description": "The watermark words (up to 80 characters)",
                    "example": "DRAFT"
                  },
                  "picture": {
                    "type": "string",
                    "format": "binary",
                    "description": "A PNG or JPEG, instead of text. Up to 10 MB."
                  },
                  "pictureBase64": {
                    "type": "string",
                    "description": "A PNG or JPEG as base64, instead of text (JSON requests)"
                  },
                  "color": {
                    "type": "string",
                    "description": "Text colour, hex. Default 808080."
                  },
                  "opacity": {
                    "type": "number",
                    "description": "Percent opaque, 5 to 100. Default 30.",
                    "minimum": 5,
                    "maximum": 100
                  },
                  "size": {
                    "type": "string",
                    "description": "Points (8 to 400) or auto. Default auto."
                  },
                  "rotation": {
                    "type": "number",
                    "description": "Degrees, -90 to 90; negative rises to the right. Default -45 for text, 0 for a picture.",
                    "minimum": -90,
                    "maximum": 90
                  },
                  "font": {
                    "type": "string",
                    "description": "Default Arial"
                  },
                  "bold": {
                    "type": "boolean",
                    "description": "Default true"
                  },
                  "widthPercent": {
                    "type": "number",
                    "description": "Picture width as a percent of the slide, 5 to 100. Default 50.",
                    "minimum": 5,
                    "maximum": 100
                  },
                  "place": {
                    "type": "string",
                    "description": "center (default), top, bottom, top-left, top-right, bottom-left or bottom-right",
                    "enum": [
                      "center",
                      "top",
                      "bottom",
                      "top-left",
                      "top-right",
                      "bottom-left",
                      "bottom-right"
                    ]
                  },
                  "layer": {
                    "type": "string",
                    "description": "behind (default) or front",
                    "enum": [
                      "behind",
                      "front"
                    ]
                  },
                  "slides": {
                    "type": "string",
                    "description": "Slides to mark, for example [1,3] or 1,3. Default all."
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 470,048 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Marked": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides marked",
                "example": "6"
              },
              "X-Already-Marked": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides that already had one of these watermarks",
                "example": "0"
              },
              "X-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Watermarks removed (remove mode)"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "470048"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "467497"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/resize": {
      "post": {
        "summary": "Change the slide size of a PowerPoint",
        "operationId": "pptxResize",
        "description": "Resizes the slides and scales shapes, pictures, tables and (unless scaleText is false) text, lines and spacing to match. Send preset (16x9, 4x3, 16x10, a4, letter) or width and height with a unit. mode fit (default) keeps the content's shape and centres it, fill covers the new area, stretch changes the shape. X-Shapes-Outside-Slide counts shapes that now reach outside the slide. 422 when the slides are already that size. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "preset": {
                    "type": "string",
                    "description": "16x9, 4x3, 16x10, a4 or letter (landscape)",
                    "enum": [
                      "16x9",
                      "4x3",
                      "16x10",
                      "a4",
                      "letter"
                    ]
                  },
                  "width": {
                    "type": "number",
                    "description": "Custom width, with height"
                  },
                  "height": {
                    "type": "number",
                    "description": "Custom height, with width"
                  },
                  "unit": {
                    "type": "string",
                    "description": "in (default), cm, mm or px",
                    "enum": [
                      "in",
                      "cm",
                      "mm",
                      "px"
                    ]
                  },
                  "mode": {
                    "type": "string",
                    "description": "fit (default), fill or stretch",
                    "enum": [
                      "fit",
                      "fill",
                      "stretch"
                    ]
                  },
                  "scaleText": {
                    "type": "boolean",
                    "description": "Scale text, lines and spacing too. Default true."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "preset": {
                    "type": "string",
                    "description": "16x9, 4x3, 16x10, a4 or letter (landscape)",
                    "enum": [
                      "16x9",
                      "4x3",
                      "16x10",
                      "a4",
                      "letter"
                    ]
                  },
                  "width": {
                    "type": "number",
                    "description": "Custom width, with height"
                  },
                  "height": {
                    "type": "number",
                    "description": "Custom height, with width"
                  },
                  "unit": {
                    "type": "string",
                    "description": "in (default), cm, mm or px",
                    "enum": [
                      "in",
                      "cm",
                      "mm",
                      "px"
                    ]
                  },
                  "mode": {
                    "type": "string",
                    "description": "fit (default), fill or stretch",
                    "enum": [
                      "fit",
                      "fill",
                      "stretch"
                    ]
                  },
                  "scaleText": {
                    "type": "boolean",
                    "description": "Scale text, lines and spacing too. Default true."
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 468,041 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-From": {
                "schema": {
                  "type": "string"
                },
                "description": "The old size",
                "example": "10 x 7.5 in (4:3)"
              },
              "X-To": {
                "schema": {
                  "type": "string"
                },
                "description": "The new size",
                "example": "13.33 x 7.5 in (16:9)"
              },
              "X-Slides": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides in the deck",
                "example": "6"
              },
              "X-Shapes-Scaled": {
                "schema": {
                  "type": "string"
                },
                "description": "Shapes scaled",
                "example": "3"
              },
              "X-Shapes-Outside-Slide": {
                "schema": {
                  "type": "string"
                },
                "description": "Shapes now partly or wholly outside the slide",
                "example": "0"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "468041"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "467497"
              },
              "X-Text-Factor": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "1"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/extract/charts": {
      "post": {
        "summary": "Get the data behind the charts of a PowerPoint",
        "operationId": "pptxExtractCharts",
        "description": "Returns the numbers of every chart in the deck: format xlsx (default; one workbook with a sheet per chart), csv (a ZIP of CSV files; workbooks=true also adds each chart's own embedded workbook) or json (each chart's slide, title, type and table). Charts pasted as pictures have no data. 422 when the deck has no real charts. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "format": {
                    "type": "string",
                    "description": "xlsx (default), csv or json",
                    "enum": [
                      "xlsx",
                      "csv",
                      "json"
                    ]
                  },
                  "workbooks": {
                    "type": "boolean",
                    "description": "csv: also include the embedded workbooks. Default false."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "format": {
                    "type": "string",
                    "description": "xlsx (default), csv or json",
                    "enum": [
                      "xlsx",
                      "csv",
                      "json"
                    ]
                  },
                  "workbooks": {
                    "type": "boolean",
                    "description": "csv: also include the embedded workbooks. Default false."
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, 16,016 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/zip or application/json": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Charts": {
                "schema": {
                  "type": "string"
                },
                "description": "Charts found",
                "example": "1"
              },
              "X-Notes": {
                "schema": {
                  "type": "string"
                },
                "description": "Notes about charts with no cached values or a linked workbook",
                "example": "0"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/accessibility-check": {
      "post": {
        "summary": "Check a PowerPoint for accessibility problems",
        "operationId": "pptxAccessibilityCheck",
        "description": "Returns a JSON report (or CSV with format csv): pictures and charts without alt text or with a file name as alt text, slides with no title or an empty or duplicate title, text under 12 points, table header rows, merged cells, vague link text and reading-order problems. Each issue has its slide, a severity (error, warning, tip) and a plain message. The check reports only and changes nothing. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "format": {
                    "type": "string",
                    "description": "json (default) or csv",
                    "enum": [
                      "json",
                      "csv"
                    ]
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "format": {
                    "type": "string",
                    "description": "json (default) or csv",
                    "enum": [
                      "json",
                      "csv"
                    ]
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file.",
            "content": {
              "application/json or text/csv": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              },
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "issues": [
                    {
                      "kind": "missing-alt",
                      "severity": "error",
                      "slide": 6,
                      "message": "Slide 6: chart \"Chart 2\" has no alt text.",
                      "shapeId": "3",
                      "shapeName": "Chart 2",
                      "objectType": "chart",
                      "fix": "alt",
                      "id": "i2"
                    },
                    {
                      "kind": "alt-filename",
                      "severity": "warning",
                      "slide": 5,
                      "message": "Slide 5: the alt text of picture \"Picture 2\" is \"image.jpg\", which looks like a file name, not a description.",
                      "shapeId": "3",
                      "shapeName": "Picture 2",
                      "objectType": "picture",
                      "fix": "alt",
                      "id": "i1"
                    }
                  ],
                  "slides": [
                    {
                      "number": 1,
                      "title": "Python slide 1",
                      "hidden": false
                    },
                    {
                      "number": 2,
                      "title": "Python slide 2",
                      "hidden": false
                    },
                    {
                      "number": 3,
                      "title": "Python slide 3",
                      "hidden": false
                    },
                    "..."
                  ],
                  "counts": {
                    "error": 1,
                    "warning": 1,
                    "tip": 0
                  },
                  "okVisuals": 0,
                  "totalVisuals": 2,
                  "documentTitle": "Python made deck"
                }
              }
            },
            "headers": {
              "X-Errors": {
                "schema": {
                  "type": "string"
                },
                "description": "Errors found"
              },
              "X-Warnings": {
                "schema": {
                  "type": "string"
                },
                "description": "Warnings found"
              },
              "X-Tips": {
                "schema": {
                  "type": "string"
                },
                "description": "Tips"
              },
              "X-Visuals-Total": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures and other visuals"
              },
              "X-Visuals-Ok": {
                "schema": {
                  "type": "string"
                },
                "description": "Visuals with alt text or marked decorative"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/repair": {
      "post": {
        "summary": "Repair a damaged PowerPoint",
        "operationId": "pptxRepair",
        "description": "Tries to mend a .pptx that PowerPoint says needs repair or will not open, and returns a new .pptx. It rebuilds a missing or wrong file list, a missing or inconsistent slide list, dead links to pictures, charts and layouts, duplicate slide ids and a damaged zip index; what cannot be saved is dropped and listed (X-Lost-Summary). A healthy file is returned unchanged with X-Changed: false. Old .ppt files and password-protected files cannot be repaired (422). 400 for a missing file; 422 with a plain message when the file is not a zip at all. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The damaged .pptx. Up to 50 MB."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 467,497 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Changed": {
                "schema": {
                  "type": "string"
                },
                "description": "true when something was mended",
                "example": "false"
              },
              "X-Zip-Rescued": {
                "schema": {
                  "type": "string"
                },
                "description": "true when the zip index was damaged and the parts were read one by one",
                "example": "false"
              },
              "X-Slides": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides in the result",
                "example": "6"
              },
              "X-Fixed": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of fixes",
                "example": "0"
              },
              "X-Lost": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of pieces that could not be kept",
                "example": "0"
              },
              "X-Fixed-Summary": {
                "schema": {
                  "type": "string"
                },
                "description": "The first fixes, in plain words"
              },
              "X-Lost-Summary": {
                "schema": {
                  "type": "string"
                },
                "description": "The first losses, in plain words"
              },
              "X-Problems-Left": {
                "schema": {
                  "type": "string"
                },
                "description": "Problems the repaired file still has, if any"
              },
              "X-Note": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "Nothing was wrong that this tool can see, so the file is returned unchanged."
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "467497"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "467497"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/redact": {
      "post": {
        "summary": "Redact text and pictures in a PowerPoint",
        "operationId": "pptxRedact",
        "description": "Blacks out sensitive text and returns the redacted .pptx. Matches are replaced by block characters in the file's own text (not covered by a shape), on slides, notes, the master and layouts, charts, SmartArt, comments, alt text and link targets. presets: email, phone, ssn, card, url, ip, money, date. terms are exact words, regexes are JavaScript regular expressions. imageSlides ('all' or slide numbers) replaces pictures with a black stand-in of the same size; imageByAlt does so for pictures whose name or alt text matches. stripNotes, stripComments and stripMetadata remove those entirely. The result is read again; X-Remaining counts matches still in the file. Text inside pictures, video and audio cannot be found (X-Warnings). A deck with no match is returned unchanged with X-Changed: false. 400 when nothing to redact is asked for or a pattern is invalid. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "presets": {
                    "type": "string",
                    "description": "Kinds of text to remove: a JSON array or comma-separated, from email, phone, ssn, card, url, ip, money, date",
                    "example": "email,phone"
                  },
                  "terms": {
                    "type": "string",
                    "description": "Exact words or phrases: a JSON array or one per line"
                  },
                  "regexes": {
                    "type": "string",
                    "description": "Regular expressions: a JSON array or one per line"
                  },
                  "matchCase": {
                    "type": "boolean",
                    "description": "Default false"
                  },
                  "notes": {
                    "type": "boolean",
                    "description": "Search speaker notes. Default true."
                  },
                  "template": {
                    "type": "boolean",
                    "description": "Search the master and layouts. Default true."
                  },
                  "imageSlides": {
                    "type": "string",
                    "description": "all, or slide numbers whose pictures are blacked out, for example [2,5] or 2,5"
                  },
                  "imageByAlt": {
                    "type": "boolean",
                    "description": "Black out pictures whose name or alt text matches"
                  },
                  "stripNotes": {
                    "type": "boolean",
                    "description": "Remove all speaker notes"
                  },
                  "stripComments": {
                    "type": "boolean",
                    "description": "Remove all comments"
                  },
                  "stripMetadata": {
                    "type": "boolean",
                    "description": "Remove author and file details"
                  },
                  "dropChartWorkbooks": {
                    "type": "boolean",
                    "description": "Remove a chart's embedded workbook when it still holds a match. Default true."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "presets": {
                    "type": "string",
                    "description": "Kinds of text to remove: a JSON array or comma-separated, from email, phone, ssn, card, url, ip, money, date",
                    "example": "email,phone"
                  },
                  "terms": {
                    "type": "string",
                    "description": "Exact words or phrases: a JSON array or one per line"
                  },
                  "regexes": {
                    "type": "string",
                    "description": "Regular expressions: a JSON array or one per line"
                  },
                  "matchCase": {
                    "type": "boolean",
                    "description": "Default false"
                  },
                  "notes": {
                    "type": "boolean",
                    "description": "Search speaker notes. Default true."
                  },
                  "template": {
                    "type": "boolean",
                    "description": "Search the master and layouts. Default true."
                  },
                  "imageSlides": {
                    "type": "string",
                    "description": "all, or slide numbers whose pictures are blacked out, for example [2,5] or 2,5"
                  },
                  "imageByAlt": {
                    "type": "boolean",
                    "description": "Black out pictures whose name or alt text matches"
                  },
                  "stripNotes": {
                    "type": "boolean",
                    "description": "Remove all speaker notes"
                  },
                  "stripComments": {
                    "type": "boolean",
                    "description": "Remove all comments"
                  },
                  "stripMetadata": {
                    "type": "boolean",
                    "description": "Remove author and file details"
                  },
                  "dropChartWorkbooks": {
                    "type": "boolean",
                    "description": "Remove a chart's embedded workbook when it still holds a match. Default true."
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.presentation, 467,497 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Text-Matches": {
                "schema": {
                  "type": "string"
                },
                "description": "Pieces of text blacked out",
                "example": "0"
              },
              "X-Matches-In-Notes": {
                "schema": {
                  "type": "string"
                },
                "description": "Of them, in speaker notes",
                "example": "0"
              },
              "X-Matches-In-Template": {
                "schema": {
                  "type": "string"
                },
                "description": "Of them, on the master or layouts",
                "example": "0"
              },
              "X-Matches-Elsewhere": {
                "schema": {
                  "type": "string"
                },
                "description": "Of them, in charts, SmartArt or comments",
                "example": "0"
              },
              "X-Pictures-Blacked": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures replaced",
                "example": "0"
              },
              "X-Alt-Text-Cleared": {
                "schema": {
                  "type": "string"
                },
                "description": "Alt texts cleared",
                "example": "0"
              },
              "X-Remaining": {
                "schema": {
                  "type": "string"
                },
                "description": "Matches still in the file after redaction (should be 0)",
                "example": "0"
              },
              "X-Remaining-Where": {
                "schema": {
                  "type": "string"
                },
                "description": "Where they are"
              },
              "X-Warnings": {
                "schema": {
                  "type": "string"
                },
                "description": "What this tool could not check, joined with ' | '"
              },
              "X-Changed": {
                "schema": {
                  "type": "string"
                },
                "description": "false when nothing matched",
                "example": "false"
              },
              "X-Chart-Workbooks-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "0"
              },
              "X-Hyperlinks-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "0"
              },
              "X-Note": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "Nothing matched, so the file is returned unchanged."
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "467497"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "467497"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/html-slideshow": {
      "post": {
        "summary": "Turn a PowerPoint into one HTML slideshow",
        "operationId": "pptxHtmlSlideshow",
        "description": "Returns ONE self-contained HTML file: each slide as readable text with its pictures inlined, arrow-key navigation, a grid (G) and optional speaker notes (N). No external files or scripts. Charts, SmartArt, video, audio and animation are not carried over (X-Not-Carried lists them). Notes are included only when includeNotes is true; hidden slides only when includeHidden is true. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "title": {
                    "type": "string",
                    "description": "Page title (up to 120 characters). Default: the deck's title."
                  },
                  "includeNotes": {
                    "type": "boolean",
                    "description": "Include speaker notes. Default false."
                  },
                  "includeHidden": {
                    "type": "boolean",
                    "description": "Include hidden slides. Default false."
                  },
                  "look": {
                    "type": "string",
                    "description": "deck (default, the deck's colours), light or dark",
                    "enum": [
                      "deck",
                      "light",
                      "dark"
                    ]
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "title": {
                    "type": "string",
                    "description": "Page title (up to 120 characters). Default: the deck's title."
                  },
                  "includeNotes": {
                    "type": "boolean",
                    "description": "Include speaker notes. Default false."
                  },
                  "includeHidden": {
                    "type": "boolean",
                    "description": "Include hidden slides. Default false."
                  },
                  "look": {
                    "type": "string",
                    "description": "deck (default, the deck's colours), light or dark",
                    "enum": [
                      "deck",
                      "light",
                      "dark"
                    ]
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, text/html, 574,385 bytes.",
            "content": {
              "text/html": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Slides": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides in the page",
                "example": "5"
              },
              "X-Pictures": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures inlined",
                "example": "1"
              },
              "X-Pictures-Left-Out": {
                "schema": {
                  "type": "string"
                },
                "description": "Pictures left out to keep the file a sensible size",
                "example": "0"
              },
              "X-Hidden-Slides-Left-Out": {
                "schema": {
                  "type": "string"
                },
                "description": "Hidden slides left out",
                "example": "1"
              },
              "X-Not-Carried": {
                "schema": {
                  "type": "string"
                },
                "description": "What was not carried over"
              },
              "X-Notes-Included": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "false"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "467497"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "574385"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/to-template": {
      "post": {
        "summary": "Make a PowerPoint template from a presentation",
        "operationId": "pptxToTemplate",
        "description": "Returns a .potx template (or, with format pptx, a re-themed deck) and optionally changes the theme: colors is a JSON object of theme colours by key (dk1, lt1, dk2, lt2, accent1 to accent6, hlink, folHlink) as six-digit hex; headingFont, bodyFont and name set the fonts and the theme's name. keepSlides keeps all, the first or none of the slides; removeNotesAndAuthor strips notes, comments and the author. Shapes with their own fixed colour or font do not follow the theme (X-Fixed-Color-Shapes and X-Fixed-Font-Runs count them). The .potx is checked in LibreOffice; it has not been tried in desktop PowerPoint. Errors: 400 for a missing file or a bad option, 422 with a plain message when the file is not a readable .pptx. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx; not .ppt, not password-protected). Up to 50 MB and 500 slides."
                  },
                  "name": {
                    "type": "string",
                    "description": "The theme's name (up to 80 characters)"
                  },
                  "colors": {
                    "type": "string",
                    "description": "JSON object, for example {\"accent1\":\"2563EB\"}"
                  },
                  "headingFont": {
                    "type": "string",
                    "description": "Heading font"
                  },
                  "bodyFont": {
                    "type": "string",
                    "description": "Body font"
                  },
                  "keepSlides": {
                    "type": "string",
                    "description": "all (default), first or none",
                    "enum": [
                      "all",
                      "first",
                      "none"
                    ]
                  },
                  "format": {
                    "type": "string",
                    "description": "potx (default) or pptx",
                    "enum": [
                      "potx",
                      "pptx"
                    ]
                  },
                  "removeNotesAndAuthor": {
                    "type": "boolean",
                    "description": "Remove notes, comments and the author's name from the kept slides"
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "name": {
                    "type": "string",
                    "description": "The theme's name (up to 80 characters)"
                  },
                  "colors": {
                    "type": "string",
                    "description": "JSON object, for example {\"accent1\":\"2563EB\"}"
                  },
                  "headingFont": {
                    "type": "string",
                    "description": "Heading font"
                  },
                  "bodyFont": {
                    "type": "string",
                    "description": "Body font"
                  },
                  "keepSlides": {
                    "type": "string",
                    "description": "all (default), first or none",
                    "enum": [
                      "all",
                      "first",
                      "none"
                    ]
                  },
                  "format": {
                    "type": "string",
                    "description": "potx (default) or pptx",
                    "enum": [
                      "potx",
                      "pptx"
                    ]
                  },
                  "removeNotesAndAuthor": {
                    "type": "boolean",
                    "description": "Remove notes, comments and the author's name from the kept slides"
                  }
                },
                "required": [
                  "fileBase64"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/vnd.openxmlformats-officedocument.presentationml.template, 467,821 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.template (or the .pptx type with format pptx)": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Format": {
                "schema": {
                  "type": "string"
                },
                "description": "potx or pptx",
                "example": "potx"
              },
              "X-Colors-Changed": {
                "schema": {
                  "type": "string"
                },
                "description": "Theme colours changed",
                "example": "0"
              },
              "X-Fonts-Changed": {
                "schema": {
                  "type": "string"
                },
                "description": "Fonts changed",
                "example": ""
              },
              "X-Slides-Kept": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides kept",
                "example": "6"
              },
              "X-Slides-Removed": {
                "schema": {
                  "type": "string"
                },
                "description": "Slides removed",
                "example": "0"
              },
              "X-Fixed-Color-Shapes": {
                "schema": {
                  "type": "string"
                },
                "description": "Colours fixed in the file that will not follow the theme",
                "example": "0"
              },
              "X-Fixed-Font-Runs": {
                "schema": {
                  "type": "string"
                },
                "description": "Font settings fixed in the file",
                "example": "0"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "467821"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "467497"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pptx/convert": {
      "post": {
        "summary": "Convert a presentation between PowerPoint, OpenDocument and PDF",
        "operationId": "pptxConvert",
        "description": "Reads a PowerPoint (.pptx, .ppt, .pps, .pot), OpenDocument (.odp) or Keynote (.key) file and returns it as pptx, odp, ppt or pdf (field to). The type is decided from the file's content, not its name. Converted on the server with LibreOffice; the file is deleted as soon as the response is sent. Layouts, fonts and animations can differ slightly after conversion (X-Note). A password-protected file, a file over 40 MB or a file that is not a presentation is refused with a plain message. 400 for a missing file, a bad 'to' or a file already in the target format; 422 when the file cannot be read; 503 with Retry-After when the converter is busy. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PowerPoint Automation"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The presentation (.pptx, .ppt, .pps, .odp or .key). Up to 40 MB."
                  },
                  "to": {
                    "type": "string",
                    "description": "The format to produce",
                    "enum": [
                      "pptx",
                      "odp",
                      "ppt",
                      "pdf"
                    ],
                    "example": "pptx"
                  }
                },
                "required": [
                  "file",
                  "to"
                ]
              },
              "example": {
                "file": "sample.pptx",
                "to": "pptx"
              }
            },
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fileBase64": {
                    "type": "string",
                    "description": "The .pptx, base64 encoded"
                  },
                  "to": {
                    "type": "string",
                    "description": "The format to produce",
                    "enum": [
                      "pptx",
                      "odp",
                      "ppt",
                      "pdf"
                    ],
                    "example": "pptx"
                  }
                },
                "required": [
                  "fileBase64",
                  "to"
                ]
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/pdf, 380,747 bytes.",
            "content": {
              "application/vnd.openxmlformats-officedocument.presentationml.presentation (or the odp, ppt or pdf type matching 'to')": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-From": {
                "schema": {
                  "type": "string"
                },
                "description": "What the file was: pptx, ppt, odp or key",
                "example": "pptx"
              },
              "X-To": {
                "schema": {
                  "type": "string"
                },
                "description": "The format produced",
                "example": "pdf"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file sent",
                "example": "467497"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "380747"
              },
              "X-Seconds": {
                "schema": {
                  "type": "string"
                },
                "description": "Time the conversion took",
                "example": "2.7"
              },
              "X-Note": {
                "schema": {
                  "type": "string"
                },
                "description": "Reminder to check the result",
                "example": "Check the result before sharing it."
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file cannot be processed (not a readable .pptx, nothing to extract or shrink, slide sizes differ, time budget spent); the JSON body has a plain-words error Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    }
  }
}