---
title: "Brainstorm a batch of post ideas"
method: POST
path: "/api/v1/generation/ideas"
tags: ["generation"]
---

# Brainstorm a batch of post ideas

`POST /api/v1/generation/ideas`

## Request

- Base URL: `https://api.cadencz.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cadencz.com/api/v1/generation/ideas`
- Auth: HTTP bearer

Turns the workspace strategy (and an optional seed topic) into a batch of concrete, on-strategy post ideas to draft next — ending the blank-page problem. Never asks the user anything; infers from stored strategy.

## Request body

- IdeasRequest
  - `seed` string, nullable: Optional focus/topic for this batch. Omit to ideate from the workspace strategy.
  - `count` integer: How many ideas to generate.

## Response `200`

Successful Response

- IdeasResponse
  - `ideas` PostIdeaRead[], required
    - `theme` string, required
    - `angle` string
    - `hook` string
    - `platform` string
    - `pillar` string
    - `why` string

## Other responses

- `401`: Missing or invalid Supabase bearer token.
- `422`: Validation Error
- `502`: The upstream provider rejected the request.
- `503`: Required infrastructure or provider config is unavailable.

---

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