Create Prompt Version

Default POST handler with automatic organization injection.

For CREATE operations:

Superadmins can specify organization_id in request body (API key only)
Regular users always use their own organization

Override this method for:

POST-for-filtering pattern (delegate to self.get())
Custom pre-create validation

Note: inject_target_organization is a DEPRECATED request.data-mutating shim kept for backward-compat during the DEV-9410 migration. The blessed path stamps org via get_create_save_kwargs → perform_create → a read_only serializer field. The shim (and these overrides' reliance on it) is removed in C18 (DEV-9430) once every view's org field is read_only.

prompt_idstring required

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_formatPublicPromptVersionCreateRequestResponseFormat

json_schemaPublicPromptVersionCreateRequestJsonSchema

descriptionstring

created_atstring date-time

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_formatPublicPromptVersionCreateResponseFormat

json_schemaPublicPromptVersionCreateJsonSchema

prompt_version_idstring required