Shape validation mode

  • Can be applied at the presentation or slide level (the lowest level takes precedence).

  • Select between the two modes: Strict or Lenient

Strict

  • The system validates all shapes defined in the payload.

  • If any shape is missing from the template.pptx, a VALIDATION_ERROR (400) is returned.

Reference: shapes

Download: input.zip

{
    "presentation": {
        "template": "template.pptx",
        "shape_validation_mode": "strict",
        "slides": [
            {
                "slide_index": 0,
                "shapes": [
                    {
                        "name": "TextBox 1",
                        "text":"Lorem ipsum dolor sit amet, consectetur adipiscing elit"
                    },
                    {
                        "name": "TextBox 500",
                        "text":"Lorem ipsum dolor sit amet, consectetur adipiscing elit"
                    },
                    {
                        "name": "TextBox 600",
                        "text":"Lorem ipsum dolor sit amet, consectetur adipiscing elit"
                    },
                    {
                        "name": "TextBox 4",
                        "text":"Lorem ipsum dolor sit amet, consectetur adipiscing elit"
                    }
                ]
            }
        ]
    }
}

Lenient

  • Missing shapes are skipped without interrupting execution.

  • This mode is useful when working with templates that have optional placeholders or evolving structures.

Reference: shapes

Download: input.zip | output.pptx


{
    "presentation": {
        "template": "template.pptx",
        "shape_validation_mode": "lenient",
        "slides": [
            {
                "slide_index": 0,
                "shapes": [
                    {
                        "name": "TextBox 1",
                        "text":"Lorem ipsum dolor sit amet, consectetur adipiscing elit"
                    },
                    {
                        "name": "TextBox 500",
                        "text":"Lorem ipsum dolor sit amet, consectetur adipiscing elit"
                    },
                    {
                        "name": "TextBox 600",
                        "text":"Lorem ipsum dolor sit amet, consectetur adipiscing elit"
                    },
                    {
                        "name": "TextBox 4",
                        "text":"Lorem ipsum dolor sit amet, consectetur adipiscing elit"
                    }
                ]
            }
        ]
    }
}

Last updated

Was this helpful?