---
title: "Generate a report layout from a natural-language prompt"
method: POST
path: "/v3/reports/generate"
tags: ["reports"]
---

# Generate a report layout from a natural-language prompt

`POST /v3/reports/generate`

## Request body

- object
  - `teamId` string
  - `prompt` string, required
  - `orientation` 'portrait' | 'landscape'
  - `language` string
  - `theme` object
  - `dateRange` object
  - `comparison` object
  - `meta` object

## Response `200`

Default Response

## Changes

- **2026-09-18** `e0163b1c37cb` — 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added
- **2026-08-26** `c44f51a92d95` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/snowseo/apis/snowseo-api/changes/v3/reports/generate/post.md)

---

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