Agenda Blocks

Author agenda slides from section lists, active section indexes, and template-driven agenda styling.

Agenda Blocks

Use an agenda block when the template slide is an agenda layout and the request needs to provide the section list. The template supplies the placement, base styling, and numbered marker style. The payload supplies the section titles and which section should be highlighted.

Basic Shape

Inside slide_data.content.blocks, an agenda block looks like this:

{
  "type": "agenda",
  "agenda": {
    "sections": [
      "Customer Health Snapshot",
      "Renewal Outlook",
      "Customer Advisory Board"
    ],
    "active_index": 0
  }
}

sections is required and must contain at least one item. active_index is optional; use null or omit it when no section should be highlighted.

Template Requirements

Agenda blocks should target agenda template slides. A compatible agenda template has:

• A one-column table or agenda text region for section titles
• Numbered oval markers or equivalent section markers
• The base font, spacing, color, and marker style you want reused

During generation, the renderer removes the existing agenda sample content and rebuilds the agenda using the provided sections array.

Active Section

active_index is zero-based. The first section is 0, the second is 1, and so on.

{
  "type": "agenda",
  "agenda": {
    "sections": [
      "Market Overview",
      "Strategy",
      "Next Steps"
    ],
    "active_index": 1,
    "active_font_color": "#CC0000",
    "active_bold": true,
    "active_underline": true
  }
}

In this example, Strategy is the active section.

If active_index is outside the section list, generation fails validation for that slide. For example, a three-section agenda accepts 0, 1, or 2.

Fields

• sections: ordered agenda section titles.
• active_index: optional zero-based index of the active section.
• active_font_color: optional hex color for the active section text.
• active_bold: optional active-section bold override. Defaults to true.
• active_underline: optional active-section underline override. Defaults to true.

When an active styling field is omitted, the renderer uses the template styling or the schema default.

Complete Example

Agenda block request example

{
  "template_slide_id": "slide_agenda",
  "slide_data": {
    "title": "Agenda",
    "content": {
      "blocks": [
        {
          "type": "agenda",
          "agenda": {
            "sections": [
              "Customer Health Snapshot",
              "Renewal Outlook",
              "Customer Advisory Board",
              "AI Copilot Reception",
              "NPS & Detractor Analysis"
            ],
            "active_index": 0,
            "active_font_color": "#CC0000",
            "active_bold": true,
            "active_underline": true
          }
        }
      ]
    }
  }
}

The visual example below is generated from the complete payload above. It shows the template agenda labels and marker styling replaced with the supplied section list, including the active section highlight.

Common Issues

• Missing agenda object: every block with type: "agenda" must include an agenda field.
• Empty sections: agenda blocks require at least one section title.
• Out-of-range active_index: the active index must point to an existing section.
• Wrong template layout: use agenda blocks with agenda template slides, not generic table or chart slides.

Related Guides

Presentation Generation

Generate a single agenda slide or include agenda slides in a full deck.

Slide Input

See how agenda blocks fit into the top-level slide_data schema.

Examples

Adapt complete request payloads for generated decks.