---
title: "List Prompts"
method: POST
path: "/api/prompts/list/"
tags: ["prompts"]
---

# List Prompts

`POST /api/prompts/list/`

POST delegates to GET — the body carries filters, not a new prompt.

## Query parameters

- `page` integer
- `page_size` integer
- `sort_by` string

## Headers

- `Authorization` string, required

## Request body

- PromptFilterRequestRequest — Shared request body for prompt POST-for-filtering endpoints.
  - `filters` object — Filter parameters keyed by metric name.

## Response `200`

- PaginatedPromptListList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `total_count` integer
  - `current_filters` FilterParamDictPydantic — Pydantic model for FilterParamDict. A dictionary that maps metric names to their filter parameters. Each key is a metric name (str), and each value can be: - A single MetricFilterParamPydantic (one condition) - A List[MetricFilterParamPydantic] (multiple conditions for same metric) - A FilterBundlePydantic (nested filter bundle with connector) Note: Uses extra="allow" for dynamic metric name fields. The __pydantic_extra__ annotation tells Pydantic what types to expect for extra fields, and generates typed additionalProperties in JSON Schema.
  - `filters_data` PaginatedPromptListListFiltersData
  - `results` PromptList[], required
    - `id` integer, required
    - `current_version` PromptVersionDetail, required
      - `id` integer, required
      - `parent_prompt` string, nullable
      - `messages` PromptChatMessage[]
        - `id` union
          - string
          - integer
        - `role` string, required
        - `content` union, required
          - string
          - PromptMultipartContent[]
            - `type` 'text' | 'image_url' | 'file', required
            - `text` string
            - `annotations` unknown
            - `image_url` PromptMultipartContentImageUrl
            - `file` PromptMultipartContentFile
        - `model` string
        - `tool_calls` PromptChatMessageToolCallsItems[]
        - `tool_call_id` string
      - `variables` object
      - `tools` PromptFunctionTool[], nullable
        - `type` 'function', required
        - `function` PromptFunctionDefinition, required — The ``function`` body of a function tool.
          - `name` string, required
          - `description` string
          - `strict` boolean
          - `additionalProperties` boolean
          - `parameters` PromptFunctionParameters — The ``parameters`` object of a function tool (JSON-schema subset).
            - `type` 'object', required
            - `properties` object
            - `required` string[]
      - `load_balance_models` PromptLoadBalanceModel[], nullable
        - `model` string
        - `weight` number, double
        - `credentials` PromptLoadBalanceModelCredentials
      - `thinking` union
        - PromptThinkingConfig — The ``thinking`` extended-reasoning config.
          - `type` 'enabled' | 'disabled', required
          - `budget_tokens` integer, required
        - unknown
      - `tool_choice` union
        - union
          - string
          - PromptToolChoiceFunction — Object form of ``tool_choice`` (the string form is handled inline).
            - `type` 'function', required
            - `function` PromptToolChoiceFunctionName, required
              - …
        - unknown
      - `response_format` PromptVersionDetailResponseFormat
      - `json_schema` PromptVersionDetailJsonSchema
      - `edited_by` Editor, required
        - `id` integer, required
        - `email` string, required
        - `name` string, required
        - `username` string
        - `first_name` string
        - `last_name` string
      - `is_deployed` boolean
      - `prompt_version_id` string
      - `description` string
      - `created_at` string, date-time
      - `updated_at` string, date-time, required
      - `version` integer
      - `model` string
      - `stream` boolean
      - `temperature` number, double, nullable
      - `max_tokens` integer, nullable
      - `top_p` number, double, nullable
      - `frequency_penalty` number, double, nullable
      - `presence_penalty` number, double, nullable
      - `reasoning_effort` string, nullable
      - `verbosity` string, nullable
      - `seed` integer, nullable
      - `readonly` boolean
      - `fallback_models` string[], nullable
      - `is_enforcing_response_format` boolean
      - `prompt` integer, required
    - `full_prompt_id` string, required
    - `created_by` integer, required
    - `project` string, nullable
    - `tags` GenericTagDisplay[], required
      - `id` string, required
      - `name` string, required
      - `color` string, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `prompt_live_version_number` integer, required
    - `live_version` PromptVersionDetail, required
      - `id` integer, required
      - `parent_prompt` string, nullable
      - `messages` PromptChatMessage[]
        - `id` union
          - string
          - integer
        - `role` string, required
        - `content` union, required
          - string
          - PromptMultipartContent[]
            - `type` 'text' | 'image_url' | 'file', required
            - `text` string
            - `annotations` unknown
            - `image_url` PromptMultipartContentImageUrl
            - `file` PromptMultipartContentFile
        - `model` string
        - `tool_calls` PromptChatMessageToolCallsItems[]
        - `tool_call_id` string
      - `variables` object
      - `tools` PromptFunctionTool[], nullable
        - `type` 'function', required
        - `function` PromptFunctionDefinition, required — The ``function`` body of a function tool.
          - `name` string, required
          - `description` string
          - `strict` boolean
          - `additionalProperties` boolean
          - `parameters` PromptFunctionParameters — The ``parameters`` object of a function tool (JSON-schema subset).
            - `type` 'object', required
            - `properties` object
            - `required` string[]
      - `load_balance_models` PromptLoadBalanceModel[], nullable
        - `model` string
        - `weight` number, double
        - `credentials` PromptLoadBalanceModelCredentials
      - `thinking` union
        - PromptThinkingConfig — The ``thinking`` extended-reasoning config.
          - `type` 'enabled' | 'disabled', required
          - `budget_tokens` integer, required
        - unknown
      - `tool_choice` union
        - union
          - string
          - PromptToolChoiceFunction — Object form of ``tool_choice`` (the string form is handled inline).
            - `type` 'function', required
            - `function` PromptToolChoiceFunctionName, required
              - …
        - unknown
      - `response_format` PromptVersionDetailResponseFormat
      - `json_schema` PromptVersionDetailJsonSchema
      - `edited_by` Editor, required
        - `id` integer, required
        - `email` string, required
        - `name` string, required
        - `username` string
        - `first_name` string
        - `last_name` string
      - `is_deployed` boolean
      - `prompt_version_id` string
      - `description` string
      - `created_at` string, date-time
      - `updated_at` string, date-time, required
      - `version` integer
      - `model` string
      - `stream` boolean
      - `temperature` number, double, nullable
      - `max_tokens` integer, nullable
      - `top_p` number, double, nullable
      - `frequency_penalty` number, double, nullable
      - `presence_penalty` number, double, nullable
      - `reasoning_effort` string, nullable
      - `verbosity` string, nullable
      - `seed` integer, nullable
      - `readonly` boolean
      - `fallback_models` string[], nullable
      - `is_enforcing_response_format` boolean
      - `prompt` integer, required
    - `name` string
    - `description` string
    - `prompt_id` string
    - `prompt_slug` string, nullable
    - `commit_count` integer, required
    - `starred` boolean
    - `deleted_at` string, date-time, nullable
    - `organization` integer, required

---

[API](https://skmtc.net/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.net/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keywordsai/api-reference/versions/c26d550029f8/schema)