For AI agents: a documentation index is available at /llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

Update Prompt Version (partial)

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…

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.

patchhttps://statsigapi.net/console/v1/prompts/{id}/versions/{versionId}

Authorizations

STATSIG-API-KEYstringrequired

apiKey (header)

Path parameters

versionIdstringrequired
idstringrequired

id

Body

application/json
promptsobject[]
Show child attributes
contentstringrequired
rolestringrequired
Allowed values:systemuserassistant
temperaturenumber
Constraints:format: double
workflow_bodyobject
Show child attributes
typestringrequired
Allowed values:JSON
valuestringrequired
workflow_urlstring

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.

Constraints:nullable
workflow_headersobject[]
Show child attributes
namestringrequired
valuestringrequired
auth_workflow_headersobject[]
Show child attributes
namestringrequired
valuestringrequired
top_pnumber
Constraints:format: double
frequency_penaltynumber
Constraints:format: double
presence_penaltynumber
Constraints:format: double
max_tokensnumber
Constraints:format: double
typestring

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.

Allowed values:LiveCandidateArchiveDraft
Other properties4
modelstring
namestring
providerstring
eval_modelstring

Response

application/json
200· Update Prompt Version
messagestringrequired

A simple string explaining the result of the operation.

dataobjectrequired
Show child attributes
idstringrequired
Constraints:min length: 3max length: 100
namestringrequired
Constraints:min length: 3max length: 100
typestring

Live is served to users; Candidate is served to code for shadow runs; Draft and Archive are not served.

Allowed values:LiveCandidateArchiveDraft
versionnumber
Constraints:format: double
promptsobject[]
rolestringrequired
contentstringrequired
modelstring
providerstring
eval_modelstring
temperaturenumber
Constraints:format: double
top_pnumber
Constraints:format: double
max_tokensnumber
Constraints:format: double
frequency_penaltynumber
Constraints:format: double
presence_penaltynumber
Constraints:format: double
workflow_urlstring
Constraints:nullable
createdTimenumber
Constraints:format: double
lastModifiedTimenumber
Constraints:format: double
eval_run_idstring

Set only by Start Prompt Version Evaluation Job: the eval run it started. Poll it with List Prompt Version Eval Runs.

404· Not Found. The requested resource could not be found.
statusintegerrequired
Allowed values:404
messagestringrequired

Was this helpful?