---
title: "Jwt Prompt Versions List List"
method: GET
path: "/prompts/jwt/prompt-versions/list/"
tags: ["prompts"]
---

# Jwt Prompt Versions List List

`GET /prompts/jwt/prompt-versions/list/`

Unified view for prompt versions list/create operations.
Supports both JWT (dashboard) and API key (public API) authentication.

Uses NestedResourceMixin for parent-aware access control:
- READ child = READ parent → superadmin can view any
- WRITE child = WRITE parent → requires org match (for JWT auth)

JWT auth: uses prompt pk from URL kwargs, exact matching
API key auth: uses prompt_id from URL kwargs, startswith matching

## Query parameters

- `page` integer
- `page_size` integer

## Headers

- `Authorization` string, required

## Response `200`

- PaginatedPromptVersionListList
  - `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` PaginatedPromptVersionListListFiltersData
  - `results` PromptVersionList[], 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
            - `name` string, required
      - unknown
    - `response_format` PromptVersionListResponseFormat
    - `json_schema` PromptVersionListJsonSchema
    - `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

---

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