v3

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

Versions Create 2

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_kwargsperform_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.

post/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_formatPublicPromptVersionDetailRequestResponseFormat
json_schemaPublicPromptVersionDetailRequestJsonSchema
is_deployedboolean
descriptionstring
created_atstring date-time
versioninteger
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
fallback_modelsstring[] nullable
is_enforcing_response_formatboolean
promptinteger required

Response

idstring required
parent_promptstring nullable
variablesobject
response_formatPublicPromptVersionDetailResponseFormat
json_schemaPublicPromptVersionDetailJsonSchema
is_deployedboolean
prompt_version_idstring required
descriptionstring
created_atstring date-time
updated_atstring date-time required
versioninteger
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
fallback_modelsstring[] nullable
is_enforcing_response_formatboolean
promptinteger required