Tag Validation Mode

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

  • Select between the two modes: Strict or Lenient

Strict

  • The system validates all tags defined in the payload.

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

Reference: tags

Download: input.zip

{
  "presentation": {
    "template": "template.pptx",
    "tag_validation_mode": "strict",
    "slides": [
      {
        "slide_index": 0,
        "tags": [
          {
            "key": "non-existent-tag",
            "value": "ONE"
          },
          {
            "key": "date",
            "value": "TWO"
          },
          {
            "key": "client",
            "value": "THREE"
          },
          {
            "key": "type",
            "value": "FOUR"
          },
          {
            "key": "month",
            "value": "FIVE"
          }
        ]
      }
    ]
  }
}

Lenient

  • Missing tags are skipped without interrupting execution.

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

Reference: tags

Download: input.zip | output.pptx


{
  "presentation": {
    "template": "template.pptx",
    "tag_validation_mode": "lenient",
    "slides": [
      {
        "type": "slide",
        "slide_index": 0,
        "tags": [
          {
            "key": "non-existent-tag",
            "value": "ONE"
          },
          {
            "key": "date",
            "value": "TWO"
          },
          {
            "key": "client",
            "value": "THREE"
          },
          {
            "key": "type",
            "value": "FOUR"
          },
          {
            "key": "month",
            "value": "FIVE"
          }
        ]
      }
    ]
  }
}

Last updated

Was this helpful?