---
title: "Update Prompt Version (partial)"
method: PATCH
path: "/console/v1/prompts/{id}/versions/{versionId}"
tags: ["Prompts"]
---

# Update Prompt Version (partial)

`PATCH /console/v1/prompts/{id}/versions/{versionId}`

## Request

- Base URL: `https://statsigapi.net`
- URL: `https://statsigapi.net/console/v1/prompts/{id}/versions/{versionId}`
- Auth: API key in header `STATSIG-API-KEY`

Change the messages, model or settings of a version, or set its type: Live promotes it, Candidate serves it to code for shadow runs, Archive retires it. Only the fields you include are changed.

## Path parameters

- `versionId` string, required
- `id` string, required

## Request body

- AIConfigPromptVersionPartialUpdateDto
  - `prompts` object[]
    - `content` string, required
    - `role` 'system' | 'user' | 'assistant', required
  - `temperature` number, double
  - `model` string
  - `name` string
  - `provider` string
  - `workflow_body` object
    - `type` 'JSON', required
    - `value` string, required
  - `workflow_url` string, nullable: Offline-eval workflow URL. Empty or null removes it. Changing it clears the stored workflow_headers and auth_workflow_headers unless they are sent in the same request.
  - `workflow_headers` object[]
    - `name` string, required
    - `value` string, required
  - `auth_workflow_headers` object[]
    - `name` string, required
    - `value` string, required
  - `eval_model` string
  - `top_p` number, double
  - `frequency_penalty` number, double
  - `presence_penalty` number, double
  - `max_tokens` number, double
  - `type` 'Live' | 'Candidate' | 'Archive' | 'Draft': Set to Live to promote the version, Candidate to serve it to code for shadow runs, Archive to retire it, or Draft to stop serving it.

## Response `200`

Update Prompt Version

- object
  - `message` string, required: A simple string explaining the result of the operation.
  - `data` object, required: A single result.
    - `id` string, required
    - `name` string, required
    - `type` 'Live' | 'Candidate' | 'Archive' | 'Draft': Live is served to users; Candidate is served to code for shadow runs; Draft and Archive are not served.
    - `version` number, double
    - `prompts` object[]
      - `role` string, required
      - `content` string, required
    - `model` string
    - `provider` string
    - `eval_model` string
    - `temperature` number, double
    - `top_p` number, double
    - `max_tokens` number, double
    - `frequency_penalty` number, double
    - `presence_penalty` number, double
    - `workflow_url` string, nullable
    - `createdTime` number, double
    - `lastModifiedTime` number, double
    - `eval_run_id` string: Set only by Start Prompt Version Evaluation Job: the eval run it started. Poll it with List Prompt Version Eval Runs.

## Other responses

- `404`: Not Found. The requested resource could not be found.

## Changes

- **2026-10-21** `df19329dc8c0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/statsig/apis/console-api/changes/console/v1/prompts/:id/versions/:versionId/patch.md)

---

[API](https://skmtc.dev/statsig/apis/console-api.md) - [All operations](https://skmtc.dev/statsig/apis/console-api/llms.txt) - [OpenAPI document](https://skmtc.dev/statsig/apis/console-api/revisions/605b784f2a7d?raw)