---
title: "List Prompts"
method: GET
path: "/api/prompts"
tags: ["prompts", "prompts"]
---

# List Prompts

`GET /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

List prompts with optional filters.

Shows ONE prompt per "function":
- Workspace customization if exists (marked as is_customized=True)
- System default otherwise

System prompts that have been customized by the workspace are hidden.

## Query parameters

- `category` string, nullable
- `context_type` string, nullable
- `search` string, nullable
- `include_archived` boolean
- `include_stats` boolean
- `include_system` boolean

## Response `200`

Successful Response

- PromptListResponse: Response for listing prompts.
  - `prompts` SrcApiPromptsPromptResponse[], required
    - `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
  - `total` integer, required

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