Retrieve a prompt version

GET

https://api.respan.ai/api/prompts/:prompt_id/versions/:version/

GET

/api/prompts/:prompt_id/versions/:version/

$ curl https://api.respan.ai/api/prompts/prompt_id/versions/3/ \
>      -H "Authorization: Bearer <respanApiKey>"

1 {
2   "id": "pv_abc123",
3   "prompt_version_id": "pv_abc123",
4   "version": 3,
5   "description": "Added context variable",
6   "messages": [
7     {
8       "role": "system",
9       "content": "You are a helpful assistant. Context: {{context}}"
10     },
11     {
12       "role": "user",
13       "content": "{{user_query}}"
14     }
15   ],
16   "thinking": null,
17   "model": "gpt-4o",
18   "stream": false,
19   "temperature": 0.7,
20   "max_tokens": 2048,
21   "top_p": 1,
22   "frequency_penalty": 0,
23   "presence_penalty": 0,
24   "reasoning_effort": null,
25   "verbosity": null,
26   "seed": null,
27   "variables": {
28     "context": "",
29     "user_query": ""
30   },
31   "fallback_models": [
32     "gpt-4o-mini"
33   ],
34   "load_balance_models": [
35     {
36       "model": "gpt-4o",
37       "weight": 0.8
38     },
39     {
40       "model": "gpt-4o-mini",
41       "weight": 0.2
42     }
43   ],
44   "tools": [
45     {
46       "type": "function",
47       "function": {
48         "name": "search_knowledge_base"
49       }
50     }
51   ],
52   "tool_choice": "auto",
53   "response_format": null,
54   "json_schema": null,
55   "is_enforcing_response_format": false,
56   "readonly": false,
57   "is_deployed": false,
58   "edited_by": {
59     "id": 123,
60     "email": "user@example.com",
61     "first_name": "John",
62     "last_name": "Doe"
63   },
64   "created_at": "2026-01-20T10:30:00Z",
65   "updated_at": "2026-01-20T10:30:00Z"
66 }

Retrieve a specific version of a prompt.

Authentication

AuthorizationBearer

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, OpenAI or Azure OpenAI provider credentials go in Settings -> Providers or the request body credential_override field, not in this auth field.

Path parameters

prompt_idstringRequired

The unique prompt identifier.

versionintegerRequired

The prompt version number.

Response

Prompt version details.

idstring

prompt_version_idstring

versioninteger

descriptionstring or null

messageslist of maps from strings to any

thinkingobject or null

modelstring

streamboolean

temperaturedouble or null

max_tokensinteger or null

top_pdouble or null

frequency_penaltydouble or null

presence_penaltydouble or null

reasoning_effortstring or null

verbositystring or null

seedinteger or null

variablesobject

fallback_modelslist of strings or null

load_balance_modelslist of objects or null

toolslist of objects or null

tool_choicestring or map from strings to any or null

response_formatobject or null

json_schemaobject or null

is_enforcing_response_formatboolean

readonlyboolean

is_deployedboolean

edited_byobject

created_atdatetime

updated_atdatetime

Errors

401

Unauthorized Error

404

Not Found Error