---
title: "Create a pitch report"
method: POST
path: "/api/v1/pitches"
tags: ["Pitch Workspace"]
---

# Create a pitch report

`POST /api/v1/pitches`

## Request

- Base URL: `https://api.athenahq.ai`
- URL: `https://api.athenahq.ai/api/v1/pitches`
- Auth: API key in header `x-api-key`

Generate a Pitch Workspace report from a public website URL. Requires a global organization API key, Pitch Workspace entitlement, and available pitch allowance. Returns a durable pitch ID while research runs. Poll GET /api/v1/pitches/{pitch_id} until pitch.status is completed or failed. The report URL is accessible to anyone holding it. Each admitted request consumes one pitch, including attempts that fail during generation. Retrying the same organization and Idempotency-Key with the same normalized input reuses the pitch; different input returns 409. Use a new key to deliberately request a fresh snapshot. Generation does not send email.

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `website_url` string, required
  - `country` string
  - `language` string

## Response `202`

Accepted, or the existing result for an idempotent retry. Generation may take several minutes.

- object
  - `pitch_id` string, uuid, required
  - `status` 'processing' | 'completed' | 'failed', required
  - `report_url` string, uri, required

## Other responses

- `400`: Invalid body, URL or missing Idempotency-Key.
- `401`: Missing or invalid API key.
- `403`: Global organization key, Pitch Workspace entitlement or pitch allowance required.
- `404`: The report for this request was deleted.
- `409`: Idempotency-Key already used with different input.
- `429`: Rate limit or three concurrent reports exceeded. Honor Retry-After.
- `500`: Admission could not be confirmed. Retry with the same Idempotency-Key promptly; contact support if unresolved.

## Changes

- **2026-11-03** `2d1d86d5e067`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/athenahq/apis/athenahq-api/changes/api/v1/pitches/post.md)

---

[API](https://skmtc.dev/athenahq/apis/athenahq-api.md) - [All operations](https://skmtc.dev/athenahq/apis/athenahq-api/llms.txt) - [OpenAPI document](https://skmtc.dev/athenahq/apis/athenahq-api/revisions/6cf9ca58edf6?raw)