v3

latestOpenAPI 3.1.02026-07-311,4541,5202.3 MB

prompts

Update Prompt Version

Default PATCH handler with automatic organization injection.

For UPDATE operations:

Superadmins preserve original ownership (org fields removed from request)
Regular users are forced to their own organization

Override this method only for custom pre-update logic.

patch/api/prompts/{prompt_id}/versions/{version}/

Path parameters

prompt_idstring required

versionstring required

Headers

Authorizationstring required

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

Request body

parent_promptstring nullable

variablesobject

response_formatPatchedPublicPromptVersionUpdateRequestResponseFormat

json_schemaPatchedPublicPromptVersionUpdateRequestJsonSchema

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

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