---
title: "POST /v1/projects/{project_id}/prompt-sets/{prompt_set_id}/generate"
method: POST
path: "/v1/projects/{project_id}/prompt-sets/{prompt_set_id}/generate"
tags: ["prompt-sets"]
---

# POST /v1/projects/{project_id}/prompt-sets/{prompt_set_id}/generate

`POST /v1/projects/{project_id}/prompt-sets/{prompt_set_id}/generate`

## Request

- Base URL: `https://api.citeladder.com`
- URL: `https://api.citeladder.com/v1/projects/{project_id}/prompt-sets/{prompt_set_id}/generate`
- Auth: HTTP bearer

## Path parameters

- `project_id` string, uuid, required
- `prompt_set_id` string, uuid, required

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `count` integer
  - `topic_ids` string[]
  - `topic_id` string, uuid, nullable
  - `agent_revision_id` string, uuid, nullable
  - `cohort` 'core' | 'comparison' | 'brand_diagnostic'

## Response `201`

Successful Response

- PromptGenerateResponse
  - `candidates` PromptCandidate[], required
    - `id` string, uuid, required
    - `run_id` string, uuid, required
    - `prompt_set_id` string, uuid, required
    - `topic_id` string, uuid, nullable, required
    - `text` string, required
    - `intent` string, required
    - `buyer_stage` '' | 'awareness' | 'consideration' | 'decision' | 'implementation', required
    - `prompt_intent` '' | 'learn' | 'solve' | 'compare' | 'recommend' | 'validate' | 'buy' | 'implement', required
    - `cohort` 'core' | 'brand_diagnostic' | 'comparison' | 'commerce', required
    - `created_at` string, required
    - `expires_at` string, required
    - `quality_status` 'judged' | 'off' | 'unavailable' | 'not_judged', required
    - `quality_flags` string[], required
    - `grounded` boolean, required
  - `topics` Topic[], required
    - `id` string, uuid, required
    - `project_id` string, uuid, required
    - `parent_id` string, uuid, nullable, required
    - `name` string, required
    - `description` string, required
    - `origin` 'manual' | 'generated', required
    - `active_count` integer, required
    - `created_at` string, required
    - `updated_at` string, required
  - `dropped_duplicates` integer, required
  - `requested_count` integer, required
  - `candidates_generated` integer, required
  - `quality_gate` 'off' | 'shadow' | 'gate' | 'unavailable', required
  - `quality_rejected` integer, required
  - `admission_drops` object, required
  - `shortfall_reason` 'deadline' | 'model_error', nullable, required

---

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