{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/slideforge-dev/json-schema/slideforge-dev-agile-workflow-request-schema.json",
  "title": "AgileWorkflowRequest",
  "description": "Shared request body for /v1/workflows/agile/* endpoints.\n\nThree input modes (mutually exclusive):\n  Mode A (stored OAuth): connection_id [+ project_id for single-project, omit for workspace-wide]\n  Mode B-staging: staging_data dict — NOT YET IMPLEMENTED in Phase A\n  Mode B-prepared: prepared_data dict (a SprintMetrics-shaped dict) → render only",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/slideforge-dev-workflows-api-openapi.yml#/components/schemas/AgileWorkflowRequest",
  "properties": {
    "connection_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Connection Id",
      "description": "OAuth connection (from /v1/oauth/{vendor}/authorize flow). Workspace-wide aggregation when project_id is omitted."
    },
    "project_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Project Id",
      "description": "Project ID (single-project mode); omit for workspace-wide aggregation."
    },
    "sprint_history": {
      "type": "integer",
      "maximum": 8.0,
      "minimum": 0.0,
      "title": "Sprint History",
      "description": "Number of past sprints for trending",
      "default": 4
    },
    "staging_data": {
      "anyOf": [
        {
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Staging Data",
      "description": "Caller-supplied canonical entities (SprintData, etc). NOT YET implemented."
    },
    "prepared_data": {
      "anyOf": [
        {
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "title": "Prepared Data",
      "description": "Pre-computed SprintMetrics-shaped dict — render only. Keys match SprintMetrics dataclass fields."
    },
    "theme_id": {
      "type": "string",
      "title": "Theme Id",
      "default": "slideforge_standard"
    },
    "options": {
      "type": "object",
      "title": "Options",
      "description": "Workflow-specific options, e.g. {exclude_slides: [...]}"
    }
  },
  "type": "object"
}