---
title: "Generate ranked, evidence-backed idea candidates"
method: POST
path: "/ideas/generate"
---

# Generate ranked, evidence-backed idea candidates

`POST /ideas/generate`

## Request

- Base URL: `https://api.bamf.ai/v1`
- URL: `https://api.bamf.ai/v1/ideas/generate`
- Auth: HTTP bearer

Requires ai:generate. Returns generated candidates; does not create idea records.

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `creator_id` string, required
  - `query` string
  - `platforms` string[]
  - `include_x_bookmarks` boolean

## Response `200`

Generated idea candidates

- GenericDataResponse
  - `data` unknown

---

[API](https://skmtc.dev/bamf/apis/bamf-developer-platform-api.md) · [All operations](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/revisions/a390dd3294bd?raw)