Jwt Prompt Versions List Update

PUT

https://api.respan.ai/prompts/jwt/prompt-versions/list/

PUT

/prompts/jwt/prompt-versions/list/

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

200Updated

1 {
2   "id": 42,
3   "edited_by": {
4     "id": 7,
5     "email": "jane.doe@respan.ai",
6     "name": "Jane Doe",
7     "username": "janedoe",
8     "first_name": "Jane",
9     "last_name": "Doe"
10   },
11   "updated_at": "2024-04-20T14:45:00Z",
12   "prompt": 42,
13   "parent_prompt": "base-prompt-2024",
14   "messages": [
15     {
16       "role": "assistant",
17       "content": "Hello! How can I assist you today?",
18       "id": "msg-001",
19       "model": "gpt-4o-mini",
20       "tool_calls": [
21         {}
22       ],
23       "tool_call_id": "toolcall-1234"
24     }
25   ],
26   "variables": {},
27   "tools": [
28     {
29       "type": "function",
30       "function": {
31         "name": "calculateSum",
32         "description": "Calculates the sum of two numbers.",
33         "strict": false,
34         "additionalProperties": false,
35         "parameters": {
36           "type": "object",
37           "properties": {},
38           "required": [
39             "a",
40             "b"
41           ]
42         }
43       }
44     }
45   ],
46   "load_balance_models": [
47     {
48       "model": "gpt-4o",
49       "weight": 0.75,
50       "credentials": {}
51     }
52   ],
53   "thinking": {
54     "type": "enabled",
55     "budget_tokens": 150
56   },
57   "tool_choice": "calculateSum",
58   "response_format": {},
59   "json_schema": {},
60   "is_deployed": true,
61   "prompt_version_id": "pv-2024-04-01",
62   "description": "Initial version of the sum calculation prompt.",
63   "created_at": "2024-01-15T09:30:00Z",
64   "version": 3,
65   "model": "gpt-4o",
66   "stream": true,
67   "temperature": 0.7,
68   "max_tokens": 256,
69   "top_p": 0.9,
70   "frequency_penalty": 0,
71   "presence_penalty": 0.1,
72   "reasoning_effort": "moderate",
73   "verbosity": "concise",
74   "seed": 123456,
75   "readonly": false,
76   "fallback_models": [
77     "gpt-3.5-turbo"
78   ],
79   "is_enforcing_response_format": true
80 }

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

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

prompt_version_idstringOptional<=70 characters

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

idintegerRead-only

edited_byobject

updated_atdatetimeRead-only

promptinteger