v3

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

Retrieve Prompt Version

Unified view for single prompt version operations (retrieve/update/delete). Supports both JWT (dashboard) and API key (public API) authentication.

Uses NestedResourceMixin for parent-aware access control:

  • READ child = READ parent → superadmin can view any
  • WRITE child = WRITE parent → requires org match (for JWT auth)

JWT auth: uses pk lookup API key auth: uses prompt_id + version lookup

get/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.

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