---
title: "Jwt Prompt Retrieve"
method: GET
path: "/prompts/jwt/prompt/{id}/"
tags: ["prompts"]
---

# Jwt Prompt Retrieve

`GET /prompts/jwt/prompt/{id}/`

Unified view for single prompt operations (retrieve/update/delete).
Supports both JWT (dashboard) and API key (public API) authentication.

Superadmin: Can READ any prompt across all organizations via JWT.
            Can WRITE across organizations via JWT with an active
            staff_write:prompts (or broad staff_write) scope.
Regular users: Can only access prompts in their organization.

JWT auth uses pk lookup, API key auth uses prompt_id (partial match).

## Path parameters

- `id` integer, required

## Headers

- `Authorization` string, required

## Response `200`

- PromptDetail
  - `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
            - `name` string, 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_versions` 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
            - `name` string, 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
  - `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
            - `name` string, 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)
