Api Prompts Versions Update 2

PUT

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

PUT

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

$ curl -X PUT https://api.respan.ai/api/prompts/prompt_id/versions/version/ \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "prompt": 1
> }'

200Updated

1 {
2   "id": "string",
3   "prompt_version_id": "string",
4   "created_at": "2024-01-15T09:30:00Z",
5   "updated_at": "2024-01-15T09:30:00Z",
6   "version": 1,
7   "readonly": true,
8   "edited_by": 1,
9   "prompt": 1,
10   "parent_prompt": "string",
11   "messages": [
12     {
13       "role": "string",
14       "content": "string",
15       "id": "string",
16       "model": "string",
17       "tool_calls": [
18         {}
19       ],
20       "tool_call_id": "string"
21     }
22   ],
23   "variables": {},
24   "tools": [
25     {
26       "type": "function",
27       "function": {
28         "name": "string",
29         "description": "string",
30         "strict": true,
31         "additionalProperties": true,
32         "parameters": {
33           "type": "object",
34           "properties": {},
35           "required": [
36             "string"
37           ]
38         }
39       }
40     }
41   ],
42   "load_balance_models": [
43     {
44       "model": "string",
45       "weight": 1.1,
46       "credentials": {}
47     }
48   ],
49   "thinking": {
50     "type": "enabled",
51     "budget_tokens": 1
52   },
53   "tool_choice": "string",
54   "response_format": {},
55   "json_schema": {},
56   "description": "string",
57   "model": "string",
58   "stream": true,
59   "temperature": 1.1,
60   "max_tokens": 1,
61   "top_p": 1.1,
62   "frequency_penalty": 1.1,
63   "presence_penalty": 1.1,
64   "reasoning_effort": "string",
65   "verbosity": "string",
66   "seed": 1,
67   "fallback_models": [
68     "string"
69   ],
70   "is_enforcing_response_format": true
71 }

Default PUT handler with automatic organization injection.

Same behavior as patch() - preserves ownership for superadmins, forces user’s org for regular users.

Authentication

AuthorizationBearer

JWT access token or Respan API key

Path parameters

prompt_idstringRequired

versionstringRequired

Request

This endpoint expects an object.

promptintegerRequired

parent_promptstring or nullOptional

messageslist of objectsOptional

variablesmap from strings to strings or objectsOptional

toolslist of objects or nullOptional

load_balance_modelslist of objects or nullOptional

thinkingobject or anyOptional

tool_choicestring or object or anyOptional

response_formatobject or nullOptional

json_schemaobject or nullOptional

descriptionstringOptional

modelstringOptional1-70 characters

streambooleanOptional

temperaturedouble or nullOptional

max_tokensinteger or nullOptional-2147483648-2147483647

top_pdouble or nullOptional

frequency_penaltydouble or nullOptional

presence_penaltydouble or nullOptional

reasoning_effortstring or nullOptional<=70 characters

verbositystring or nullOptional<=50 characters

seedinteger or nullOptional-2147483648-2147483647

fallback_modelslist of strings or nullOptional

is_enforcing_response_formatbooleanOptional

Response

idstringRead-only

prompt_version_idstringRead-only

created_atdatetimeRead-only

updated_atdatetimeRead-only

versionintegerRead-only

readonlybooleanRead-only

edited_byinteger or nullRead-only

promptinteger

parent_promptstring or null

messageslist of objects

variablesmap from strings to strings or objects

toolslist of objects or null

load_balance_modelslist of objects or null

thinkingobject or any

tool_choicestring or object or any

response_formatobject or null

json_schemaobject or null

descriptionstring

modelstring<=70 characters

streamboolean

temperaturedouble or null

max_tokensinteger or null-2147483648-2147483647

top_pdouble or null

frequency_penaltydouble or null

presence_penaltydouble or null

reasoning_effortstring or null<=70 characters

verbositystring or null<=50 characters

seedinteger or null-2147483648-2147483647

fallback_modelslist of strings or null

is_enforcing_response_formatboolean