---
title: "Generate an Executive Snapshot (1-2 slide leadership-facing RAG report)"
method: POST
path: "/v1/workflows/agile/executive-snapshot"
tags: ["workflows"]
---

# Generate an Executive Snapshot (1-2 slide leadership-facing RAG report)

`POST /v1/workflows/agile/executive-snapshot`

## Request

- Base URL: `https://api.slideforge.dev`
- URL: `https://api.slideforge.dev/v1/workflows/agile/executive-snapshot`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Smallest agile archetype — designed to read in <30 seconds.

Slide 1: Big RAG status banner (ON TRACK / AT RISK / OFF TRACK) + 4 KPI tiles (completion, velocity, cycle time, defect rate) + key updates list.
Slide 2 (optional): Velocity & throughput trend chart + 3-5 explanatory bullets.

**Audience:** executives, sponsors, steering committees.
**Cadence:** weekly or per-sprint.
**Scope:** project (with project_id) or workspace-wide.

**Modes:** `connection_id` (we fetch from Zoho) or `prepared_data` (SprintMetrics-shaped dict). Pricing $0.06 per report (2 × $0.03).

## Request body

- AgileWorkflowRequest: Shared request body for /v1/workflows/agile/* endpoints. Three input modes (mutually exclusive): Mode A (stored OAuth): connection_id [+ project_id for single-project, omit for workspace-wide] Mode B-staging: staging_data dict — NOT YET IMPLEMENTED in Phase A Mode B-prepared: prepared_data dict (a SprintMetrics-shaped dict) → render only
  - `connection_id` string, nullable: OAuth connection (from /v1/oauth/{vendor}/authorize flow). Workspace-wide aggregation when project_id is omitted.
  - `project_id` string, nullable: Project ID (single-project mode); omit for workspace-wide aggregation.
  - `sprint_history` integer: Number of past sprints for trending
  - `staging_data` object, nullable: Caller-supplied canonical entities (SprintData, etc). NOT YET implemented.
  - `prepared_data` object, nullable: Pre-computed SprintMetrics-shaped dict — render only. Keys match SprintMetrics dataclass fields.
  - `theme_id` string
  - `options` object: Workflow-specific options, e.g. {exclude_slides: [...]}

## Response `202`

Report queued — poll GET /v1/jobs/{deck_id}

- unknown

## Other responses

- `400`: Invalid input
- `401`: Authentication required
- `422`: Validation Error

---

[API](https://skmtc.dev/slideforge/apis/slideforge-api.md) · [All operations](https://skmtc.dev/slideforge/apis/slideforge-api/llms.txt) · [OpenAPI document](https://skmtc.dev/slideforge/apis/slideforge-api/revisions/ae698e3d3c00?raw)