v3

latestOpenAPI 3.1.02026-07-311,4541,5202.3 MB
prompts

Versions Update 2

Default PUT handler with automatic organization injection.

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

put/prompts/{prompt_id}/versions/{version}/

Path parameters

prompt_idstring required
versionstring required

Headers

Authorizationstring required

JWT access token or Respan API key

Request body

parent_promptstring nullable
variablesobject
response_formatPublicPromptVersionUpdateRequestResponseFormat
json_schemaPublicPromptVersionUpdateRequestJsonSchema
descriptionstring
modelstring
streamboolean
temperaturenumber double nullable
max_tokensinteger nullable
top_pnumber double nullable
frequency_penaltynumber double nullable
presence_penaltynumber double nullable
reasoning_effortstring nullable
verbositystring nullable
seedinteger nullable
fallback_modelsstring[] nullable
is_enforcing_response_formatboolean
promptinteger required

Response

idstring required
parent_promptstring nullable
variablesobject
response_formatPublicPromptVersionUpdateResponseFormat
json_schemaPublicPromptVersionUpdateJsonSchema
prompt_version_idstring required
descriptionstring
created_atstring date-time required
updated_atstring date-time required
versioninteger required
modelstring
streamboolean
temperaturenumber double nullable
max_tokensinteger nullable
top_pnumber double nullable
frequency_penaltynumber double nullable
presence_penaltynumber double nullable
reasoning_effortstring nullable
verbositystring nullable
seedinteger nullable
readonlyboolean required
fallback_modelsstring[] nullable
is_enforcing_response_formatboolean
edited_byinteger nullable required
promptinteger required