damnpdfs.com

{
  "type": "object",
  "properties": {
    "files": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "File/artifact handles imported into this session."
    },
    "options": {
      "type": "object",
      "properties": {
        "pages": {
          "type": "string",
          "description": "Choose which pages to process. “all” includes every page; 1-3, 5 selects pages 1, 2, 3 and 5. Page numbers start at 1.",
          "default": "all"
        },
        "text": {
          "type": "string",
          "description": "The text to include in the output. Your original file is kept unchanged.",
          "default": ""
        },
        "fontSize": {
          "type": "number",
          "description": "Text size in points: 12 is comfortable body text, 18–24 suits headings. One point is 1/72 of an inch.",
          "default": 12
        },
        "color": {
          "type": "string",
          "description": "Choose the colour of added text or marks. This does not recolour the original document.",
          "default": "#171717"
        },
        "x": {
          "type": "number",
          "description": "Distance from the left edge, in points. 72 points equals one inch.",
          "default": 72
        },
        "y": {
          "type": "number",
          "description": "Distance from the top edge, in points. 72 points equals one inch.",
          "default": 72
        },
        "objectTransforms": {
          "type": "array",
          "maxItems": 10000,
          "description": "Move or resize original top-level objects using pages[].objects[].index from document_inspect with objects=true. Zero-based page indices and absolute bounds in points from the visible page top-left. Use each original object once; text edits and removals in the same request retain source indices.",
          "items": {
            "type": "object",
            "properties": {
              "page": {
                "type": "integer",
                "minimum": 0
              },
              "index": {
                "type": "integer",
                "minimum": 0
              },
              "x": {
                "type": "number"
              },
              "y": {
                "type": "number"
              },
              "width": {
                "type": "number",
                "exclusiveMinimum": 0
              },
              "height": {
                "type": "number",
                "exclusiveMinimum": 0
              }
            },
            "required": [
              "page",
              "index",
              "x",
              "y",
              "width",
              "height"
            ],
            "additionalProperties": false
          }
        },
        "deletedObjects": {
          "type": "array",
          "maxItems": 10000,
          "description": "Remove original top-level objects by pages[].objects[].index from document_inspect with objects=true. Zero-based page indices. Removal takes precedence over an edit or move of the same object.",
          "items": {
            "type": "object",
            "properties": {
              "page": {
                "type": "integer",
                "minimum": 0
              },
              "index": {
                "type": "integer",
                "minimum": 0
              }
            },
            "required": [
              "page",
              "index"
            ],
            "additionalProperties": false
          }
        },
        "addedPages": {
          "type": "integer",
          "minimum": 0,
          "maximum": 50,
          "default": 0,
          "description": "Append up to 50 blank pages matching the final source page visible dimensions. Added pages use zero-based indices starting at the source pageCount; overlays can target them in the same request."
        },
        "edits": {
          "type": "array",
          "maxItems": 10000,
          "description": "Use the original pages[].runs[].index from document_inspect, with zero-based page indices. Do not use pages[].objects[].index: those indices are for object removal. Empty replacement text deletes its text object. Changed and added text together are limited to 250,000 characters.",
          "items": {
            "type": "object",
            "properties": {
              "page": {
                "type": "integer",
                "minimum": 0
              },
              "index": {
                "type": "integer",
                "minimum": 0
              },
              "text": {
                "type": "string",
                "maxLength": 250000
              }
            },
            "required": [
              "page",
              "index",
              "text"
            ]
          }
        },
        "overlays": {
          "type": "array",
          "maxItems": 10000,
          "description": "Additional text, images, rectangles, ellipses or lines, in points from the visible page top-left. Include text for text content, or an imported image handle for images. Changed and added text together are limited to 250,000 characters.",
          "items": {
            "type": "object",
            "properties": {
              "page": {
                "type": "integer",
                "minimum": 0
              },
              "kind": {
                "type": "string",
                "enum": [
                  "text",
                  "image",
                  "rectangle",
                  "ellipse",
                  "line"
                ]
              },
              "x": {
                "type": "number"
              },
              "y": {
                "type": "number"
              },
              "width": {
                "type": "number",
                "exclusiveMinimum": 0
              },
              "height": {
                "type": "number",
                "description": "Positive dimensions except lines, whose signed height is the vertical change to their endpoint."
              },
              "text": {
                "type": "string",
                "minLength": 1,
                "maxLength": 250000,
                "pattern": "\\S"
              },
              "file": {
                "type": "string",
                "minLength": 1,
                "maxLength": 500
              },
              "color": {
                "type": "string",
                "pattern": "^#[0-9a-fA-F]{6}$"
              },
              "fontSize": {
                "type": "number",
                "minimum": 5,
                "maximum": 150
              },
              "opacity": {
                "type": "number",
                "minimum": 0,
                "maximum": 1,
                "default": 1,
                "description": "Zero is invisible; one is fully opaque. Originals remain unchanged."
              }
            },
            "required": [
              "page",
              "kind",
              "x",
              "y"
            ],
            "allOf": [
              {
                "if": {
                  "properties": {
                    "kind": {
                      "const": "text"
                    }
                  }
                },
                "then": {
                  "required": [
                    "text"
                  ]
                }
              },
              {
                "if": {
                  "properties": {
                    "kind": {
                      "const": "image"
                    }
                  }
                },
                "then": {
                  "required": [
                    "file"
                  ]
                }
              },
              {
                "if": {
                  "properties": {
                    "kind": {
                      "enum": [
                        "text",
                        "image",
                        "rectangle",
                        "ellipse"
                      ]
                    }
                  }
                },
                "then": {
                  "properties": {
                    "height": {
                      "exclusiveMinimum": 0
                    }
                  }
                }
              }
            ]
          }
        },
        "processing": {
          "type": "string",
          "enum": [
            "browser",
            "cloud"
          ],
          "description": "Execution location; cloud requires temporary upload."
        }
      },
      "additionalProperties": true
    }
  },
  "additionalProperties": false
}