---
title: "Generate Report Route"
method: POST
path: "/api/reports/generate"
tags: ["reports"]
---

# Generate Report Route

`POST /api/reports/generate`

## Request body

- GenerateReportRequest
  - `type` 'executive' | 'campaign' | 'agent_performance' | 'conversation' | 'lead' | 'cost_roi' | 'knowledge_base' | 'compliance' | 'summarizer_brief', required
  - `format` 'pdf' | 'xlsx' | 'csv' | 'docx' | 'png', required
  - `name` string, nullable
  - `startDate` string, nullable
  - `endDate` string, nullable
  - `agentId` string, nullable
  - `useCaseId` string, nullable
  - `source` string, nullable
  - `campaignId` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-08-21** `2a1adc380310` — 1 breaking, 12 info
  - request property `type` was restricted to a list of enum values
  - added the new optional request property `useCaseId`
  - added the new `agent_performance` enum value to the request property `type`
  - added the new `campaign` enum value to the request property `type`
  - …9 more
- **2026-08-03** `5e64ef81321b` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/outcallerai/apis/fastapi/changes/api/reports/generate/post.md)

---

[API](https://skmtc.dev/outcallerai/apis/fastapi.md) · [All operations](https://skmtc.dev/outcallerai/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/outcallerai/fastapi/revisions/6155db644bab/schema)