---
title: "Jwt Prompt Versions Partial Update"
method: PATCH
path: "/prompts/jwt/prompt-versions/"
tags: ["prompts"]
---

# Jwt Prompt Versions Partial Update

`PATCH /prompts/jwt/prompt-versions/`

Default PATCH handler with automatic organization injection.

For UPDATE operations:
- Superadmins preserve original ownership (org fields removed from request)
- Regular users are forced to their own organization

Override this method only for custom pre-update logic.

## Headers

- `Authorization` string, required

## Request body

- PatchedPromptVersionListRequest
  - `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` PatchedPromptVersionListRequestResponseFormat
  - `json_schema` PatchedPromptVersionListRequestJsonSchema
  - `is_deployed` boolean
  - `prompt_version_id` string
  - `description` string
  - `created_at` string, date-time
  - `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

## Response `200`

- PromptVersionList
  - `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)