---
title: "Create Prompt"
method: POST
path: "/prompts/"
tags: ["prompts"]
---

# Create Prompt

`POST /prompts/`

## Request

- Base URL: `https://dev.whispa.net` (the document declares no server; this is the origin it was published from)
- URL: `https://dev.whispa.net/prompts/`
- Auth: one of:
  - OAuth 2
    - Password
    - Token URL: `auth/bearer/login`
  - API key in cookie `access_token`

Create a new prompt.

## Request body

- PromptCreate: Input schema for creating a new prompt.
  - `name` string, required: Unique prompt name
  - `type` string, required: Prompt type: coaching, summary, action_cards, suggested_responses, or tagging
  - `content` string, required: Prompt content/text
  - `description` string, nullable: Optional description
  - `config` PromptConfigInput: Type-specific configuration for prompts. For coaching prompts, includes dimension definitions. Can be extended for other prompt types as needed.
    - `dimensions` object, nullable: Coaching dimensions (only for coaching prompts)

## Response `201`

Successful Response

- PromptResponse: Response data for a prompt.
  - `id` string, uuid, required
  - `name` string, required
  - `type` string, required
  - `content` string, required
  - `description` string, nullable, required
  - `config` object, nullable: Type-specific configuration
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

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