Tag Validation Mode

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

  2. Select between the two modes: Strict or Lenient

Strict

  1. The system validates all tags defined in the payload.

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

Reference: tags

Download: input.ziparrow-up-right

{
  "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

  1. Missing tags are skipped without interrupting execution.

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

Reference: tags

Download: input.ziparrow-up-right | output.pptxarrow-up-right


{
  "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