API ReferencePrompts

Update a prompt version

Update a prompt version's messages, model, parameters, or deploy it as the live version.

Path parameters

prompt_idstringRequired
Prompt Id
versionstringRequired
Version

Headers

AuthorizationstringRequired

Bearer token. Use Bearer YOUR_API_KEY.

Request

This endpoint expects an object.
messageslist of anyOptional

Messages for this version. Use {{variable_name}} for template variables.

modelstringOptional
Model for this version.
descriptionstringOptional
Version description.
streambooleanOptionalDefaults to false
Whether to stream responses.
temperaturedoubleOptional

Sampling temperature (0-2).

max_tokensintegerOptional
Maximum tokens to generate.
top_pdoubleOptional
Nucleus sampling parameter.
frequency_penaltydoubleOptional

Frequency penalty (-2 to 2).

presence_penaltydoubleOptional

Presence penalty (-2 to 2).

variablesobjectOptional
Template variables and default values.
fallback_modelslist of stringsOptional
Fallback models.
toolslist of anyOptional
Tools for function calling.
deploybooleanOptionalDefaults to false
Deploy this version as the live version.

Response

Successful response for Update prompt version
variablesobject

Errors

401
Unauthorized Error
404
Not Found Error