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

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

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

## Request

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

## Path parameters

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

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `prompts` object[], required
    - `text` string, required
    - `theme` string
    - `intent` string
    - `buyer_stage` '' | 'awareness' | 'consideration' | 'decision' | 'implementation'
    - `persona` string
    - `cohort` 'core' | 'brand_diagnostic' | 'comparison' | 'commerce'
    - `enabled` boolean
    - `topic_id` string, uuid, nullable

## Response `201`

Successful Response

- object
  - `prompts` Prompt[], required
    - `id` string, uuid, required
    - `prompt_set_id` string, uuid, required
    - `topic_id` string, uuid, nullable
    - `text` string, required
    - `theme` string, required
    - `intent` '' | 'discovery' | 'comparison' | 'purchase' | 'service' | 'local', required
    - `buyer_stage` '' | 'awareness' | 'consideration' | 'decision' | 'implementation', required
    - `prompt_intent` '' | 'learn' | 'solve' | 'compare' | 'recommend' | 'validate' | 'buy' | 'implement', required
    - `persona` string, required
    - `cohort` 'core' | 'brand_diagnostic' | 'comparison' | 'commerce', required
    - `branded` boolean, required
    - `enabled` boolean, required
    - `status` 'active' | 'archived', required
    - `origin` 'manual' | 'imported' | 'generated', required
    - `over_plan_limit` boolean, required
    - `created_at` string
    - `updated_at` string

---

[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)