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

# Create Prompt

`POST /api/prompts`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/prompts`
- Auth: none declared

Create a new prompt in the workspace.

## Request body

- PromptCreate: Request to create a new prompt.
  - `name` string, required
  - `description` string, nullable
  - `category` string, required
  - `context_type` string[]
  - `tags` string[]
  - `prompt_text` string, required
  - `auto_reply_rules` string, nullable
  - `model` string
  - `cooldown_minutes` integer
  - `max_per_day` integer
  - `advanced_settings` AdvancedSettings: Advanced LLM settings stored in JSONB.
    - `temperature` number
    - `max_tokens` integer
    - `tone` string
    - `formality` string
    - `emoji_usage` boolean
    - `preferred_length` string
    - `max_words` integer, nullable
    - `language` string
    - `access_mode` string
    - `use_rag` boolean
    - `use_thread_summary` boolean
    - `pinned_files_only` boolean
    - `enable_tools` boolean
    - `max_tool_calls` integer
    - `system_prompt_template` string, nullable
    - `calendar_url` string, nullable
    - `website_url` string, nullable
    - `scope_mode` string
    - `rag_score_threshold` number

## Response `201`

Successful Response

- SrcApiPromptsPromptResponse: Response for a single prompt.
  - `id` integer, required
  - `user_id` integer, nullable, required
  - `name` string, required
  - `description` string, nullable, required
  - `category` string, required
  - `context_type` string[], required
  - `tags` string[], required
  - `prompt_text` string, required
  - `auto_reply_rules` string, nullable
  - `model` string, required
  - `cooldown_minutes` integer, required
  - `max_per_day` integer, required
  - `advanced_settings` object, required
  - `sort_order` integer, required
  - `is_archived` boolean, required
  - `created_at` string, required
  - `updated_at` string, required
  - `is_system` boolean
  - `is_customized` boolean
  - `based_on_system_id` integer, nullable
  - `is_default_for` string[], nullable
  - `assignment_count` integer
  - `stats` PromptStats: Aggregated stats for a prompt.
    - `total_uses` integer
    - `successful_sends` integer
    - `approvals` integer
    - `rejections` integer
    - `edits` integer
    - `edit_rate` number
    - `avg_response_time_ms` number, nullable
    - `avg_tokens_used` number, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/77bef09a9209?raw)