Versions Update

PUT

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

PUT

/prompts/:prompt_id/versions/

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

200Updated

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

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

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

is_deployedbooleanOptional

descriptionstringOptional

created_atdatetimeOptional

versionintegerOptional-2147483648-2147483647

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

readonlybooleanOptional

fallback_modelslist of strings or nullOptional

is_enforcing_response_formatbooleanOptional

Response

idstringRead-only

edited_byobject

prompt_version_idstringRead-only

updated_atdatetimeRead-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

is_deployedboolean

descriptionstring

created_atdatetime

versioninteger-2147483648-2147483647

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

readonlyboolean

fallback_modelslist of strings or null

is_enforcing_response_formatboolean