---
title: "POST /reports/generations"
method: POST
path: "/reports/generations"
tags: ["Reports"]
---

# POST /reports/generations

`POST /reports/generations`

## Headers

- `X-Greentally-Organization-Id` string

## Request body

- ReportGenerationRequest
  - `advancedFilters` object
  - `dashboardContext` object
  - `dashboardLayoutId` string
  - `framework` 'ghg_protocol' | 'csrd_esrs' | 'management', required
  - `period` object, required
    - `endDate` string, date-time, required
    - `startDate` string, date-time, required
  - `template` 'executive_carbon_summary' | 'dashboard_snapshot_report', required
  - `tone` 'conservative' | 'consultant' | 'executive_narrative', required

## Response `200`

Report draft created

- ReportGenerationResponse
  - `data` object, required
    - `generationId` string, required
    - `report` ReportDetail, required
      - `accessReason` 'owned_by_me' | 'shared_with_me' | 'organization_access'
      - `createdAt` string, date-time, required
      - `draftVersionId` string
      - `framework` 'ghg_protocol' | 'csrd_esrs' | 'management', required
      - `id` string, required
      - `latestPublishedAt` string, date-time
      - `latestPublishedVersionId` string
      - `sourceOrganizationName` string
      - `template` 'executive_carbon_summary' | 'dashboard_snapshot_report', required
      - `title` string, required
      - `tone` 'conservative' | 'consultant' | 'executive_narrative', required
      - `updatedAt` string, date-time, required
      - `draft` object
      - `evidencePack` object
      - `validation` object
      - `versionId` string
      - `versionStatus` 'draft' | 'published' | 'archived'

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[API](https://skmtc.dev/greentally/apis/esgai-api.md) · [All operations](https://skmtc.dev/greentally/apis/esgai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greentally/esgai-api/revisions/09945036a28b/schema)