---
title: "Jwt Prompt Version Update"
method: PUT
path: "/prompts/jwt/prompt-version/{id}/"
tags: ["prompts"]
---

# Jwt Prompt Version Update

`PUT /prompts/jwt/prompt-version/{id}/`

Default PUT handler with automatic organization injection.

Same behavior as patch() - preserves ownership for superadmins,
forces user's org for regular users.

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required

## Request body

- PromptVersionUpdateRequest
  - `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` PromptVersionUpdateRequestResponseFormat
  - `json_schema` PromptVersionUpdateRequestJsonSchema
  - `description` string
  - `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
  - `fallback_models` string[], nullable
  - `is_enforcing_response_format` boolean
  - `prompt` integer, required

## Response `200`

- PromptVersionUpdate
  - `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` PromptVersionUpdateResponseFormat
  - `json_schema` PromptVersionUpdateJsonSchema
  - `prompt_version_id` string, required
  - `description` string
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `version` integer, required
  - `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, required
  - `fallback_models` string[], nullable
  - `is_enforcing_response_format` boolean
  - `edited_by` integer, nullable, required
  - `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)