Api Prompts List Update

PUT

https://api.respan.ai/api/prompts/list/

PUT

/api/prompts/list/

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

200Updated

1 {
2   "id": "a1b2c3d4-e5f6-7890-ab12-cd34ef567890",
3   "current_version": {
4     "id": "ver-12345",
5     "edited_by": {
6       "id": 101,
7       "email": "editor@example.com",
8       "name": "Jane Doe",
9       "username": "janedoe",
10       "first_name": "Jane",
11       "last_name": "Doe"
12     },
13     "prompt_version_id": "ver-12345",
14     "updated_at": "2024-01-15T09:30:00Z",
15     "prompt": 1001,
16     "parent_prompt": "base-prompt-001",
17     "messages": [
18       {
19         "role": "system",
20         "content": "Welcome to the Respan prompt system.",
21         "id": "msg-98765",
22         "model": "gpt-4-respan-v1",
23         "tool_calls": [
24           {}
25         ],
26         "tool_call_id": "toolcall-45678"
27       }
28     ],
29     "variables": {},
30     "tools": [
31       {
32         "type": "function",
33         "function": {
34           "name": "calculateSentiment",
35           "description": "Analyzes the sentiment of the input text.",
36           "strict": true,
37           "additionalProperties": true,
38           "parameters": {
39             "type": "object",
40             "properties": {},
41             "required": [
42               "text"
43             ]
44           }
45         }
46       }
47     ],
48     "load_balance_models": [
49       {
50         "model": "gpt-4-respan-v1",
51         "weight": 1.5,
52         "credentials": {}
53       }
54     ],
55     "thinking": {
56       "type": "enabled",
57       "budget_tokens": 500
58     },
59     "tool_choice": "function",
60     "response_format": {},
61     "json_schema": {},
62     "is_deployed": true,
63     "description": "Initial version of the sentiment analysis prompt.",
64     "created_at": "2024-01-15T09:30:00Z",
65     "version": 1,
66     "model": "gpt-4-respan-v1",
67     "stream": true,
68     "temperature": 0.7,
69     "max_tokens": 1024,
70     "top_p": 0.9,
71     "frequency_penalty": 0,
72     "presence_penalty": 0,
73     "reasoning_effort": "moderate",
74     "verbosity": "concise",
75     "seed": 123456,
76     "readonly": true,
77     "fallback_models": [
78       "gpt-3.5-respan"
79     ],
80     "is_enforcing_response_format": true
81   },
82   "full_prompt_id": "full-prompt-1001",
83   "created_by": 101,
84   "tags": [
85     {
86       "id": "tag-001",
87       "name": "sentiment",
88       "color": "#FF5733",
89       "created_at": "2024-01-10T08:00:00Z",
90       "updated_at": "2024-01-12T10:00:00Z"
91     }
92   ],
93   "prompt_live_version_number": 1,
94   "live_version": {
95     "id": 1,
96     "edited_by": {
97       "id": 101,
98       "email": "editor@example.com",
99       "name": "Jane Doe",
100       "username": "janedoe",
101       "first_name": "Jane",
102       "last_name": "Doe"
103     },
104     "updated_at": "2024-01-15T09:30:00Z",
105     "prompt": 1001,
106     "parent_prompt": "base-prompt-001",
107     "messages": [
108       {
109         "role": "system",
110         "content": "Welcome to the Respan prompt system.",
111         "id": "msg-98765",
112         "model": "gpt-4-respan-v1",
113         "tool_calls": [
114           {}
115         ],
116         "tool_call_id": "toolcall-45678"
117       }
118     ],
119     "variables": {},
120     "tools": [
121       {
122         "type": "function",
123         "function": {
124           "name": "calculateSentiment",
125           "description": "Analyzes the sentiment of the input text.",
126           "strict": true,
127           "additionalProperties": true,
128           "parameters": {
129             "type": "object",
130             "properties": {},
131             "required": [
132               "text"
133             ]
134           }
135         }
136       }
137     ],
138     "load_balance_models": [
139       {
140         "model": "gpt-4-respan-v1",
141         "weight": 1.5,
142         "credentials": {}
143       }
144     ],
145     "thinking": {
146       "type": "enabled",
147       "budget_tokens": 500
148     },
149     "tool_choice": "function",
150     "response_format": {},
151     "json_schema": {},
152     "is_deployed": true,
153     "prompt_version_id": "ver-12345",
154     "description": "Initial version of the sentiment analysis prompt.",
155     "created_at": "2024-01-15T09:30:00Z",
156     "version": 1,
157     "model": "gpt-4-respan-v1",
158     "stream": true,
159     "temperature": 0.7,
160     "max_tokens": 1024,
161     "top_p": 0.9,
162     "frequency_penalty": 0,
163     "presence_penalty": 0,
164     "reasoning_effort": "moderate",
165     "verbosity": "concise",
166     "seed": 123456,
167     "readonly": true,
168     "fallback_models": [
169       "gpt-3.5-respan"
170     ],
171     "is_enforcing_response_format": true
172   },
173   "commit_count": 5,
174   "organization": 42,
175   "project": "Sentiment Analysis",
176   "name": "Sentiment Analysis Prompt",
177   "description": "A prompt designed to analyze sentiment in user input.",
178   "prompt_id": "sentiment-prompt-001",
179   "prompt_slug": "sentiment-analysis-prompt",
180   "starred": true,
181   "deleted_at": "2024-01-15T09:30:00Z"
182 }

PUT handler with superadmin lock and field protection.

Same as patch() - checks lock and field protection before delegating.

Authentication

AuthorizationBearer

JWT access token or Respan API key

Request

This endpoint expects an object.

organizationintegerRequired

projectstring or nullOptional>=1 character

namestringOptional1-100 characters

descriptionstringOptional

prompt_idstringOptional<=70 characters

prompt_slugstring or nullOptional<=100 characters

starredbooleanOptional

deleted_atdatetime or nullOptional

Response

idstringRead-only

current_versionobject

full_prompt_idstringRead-only

created_byintegerRead-only

tagslist of objectsRead-only

prompt_live_version_numberintegerRead-only

live_versionobject

commit_countintegerRead-only

organizationinteger

projectstring or nullOptional

namestringOptional<=100 characters

descriptionstringOptional

prompt_idstringOptional<=70 characters

prompt_slugstring or nullOptional<=100 characters

starredbooleanOptional

deleted_atdatetime or nullOptional