CreateReportRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/CreateReportRequest",
  "title": "CreateReportRequest",
  "type": "object",
  "description": "Request to create a new report",
  "required": [
    "name",
    "report_type",
    "category_id",
    "start_date",
    "end_date"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Report name",
      "example": "Q1 2026 Snacks Performance"
    },
    "report_type": {
      "type": "string",
      "description": "Type of report to generate",
      "enum": [
        "market_review",
        "brand_performance",
        "category_analysis",
        "competitive_landscape",
        "pricing_analysis"
      ],
      "example": "market_review"
    },
    "category_id": {
      "type": "string",
      "description": "Product category for the report",
      "example": "cpg-snacks"
    },
    "start_date": {
      "type": "string",
      "format": "date",
      "description": "Report start date",
      "example": "2026-01-01"
    },
    "end_date": {
      "type": "string",
      "format": "date",
      "description": "Report end date",
      "example": "2026-03-31"
    },
    "geography": {
      "type": "string",
      "description": "Geographic scope",
      "example": "national"
    },
    "metrics": {
      "type": "array",
      "description": "Metrics to include in the report",
      "items": {
        "type": "string"
      },
      "example": [
        "dollar_sales",
        "unit_sales",
        "market_share"
      ]
    }
  }
}