Jwt Prompt Create

POST

https://api.respan.ai/prompts/jwt/prompt/:id/

POST

/prompts/jwt/prompt/:id/

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

200Successful

1 {
2   "id": 1,
3   "current_version": {
4     "id": 1,
5     "edited_by": {
6       "id": 1,
7       "email": "string",
8       "name": "string",
9       "username": "string",
10       "first_name": "string",
11       "last_name": "string"
12     },
13     "updated_at": "2024-01-15T09:30:00Z",
14     "prompt": 1,
15     "parent_prompt": "string",
16     "messages": [
17       {
18         "role": "string",
19         "content": "string",
20         "id": "string",
21         "model": "string",
22         "tool_calls": [
23           {}
24         ],
25         "tool_call_id": "string"
26       }
27     ],
28     "variables": {},
29     "tools": [
30       {
31         "type": "function",
32         "function": {
33           "name": "string",
34           "description": "string",
35           "strict": true,
36           "additionalProperties": true,
37           "parameters": {
38             "type": "object",
39             "properties": {},
40             "required": [
41               "string"
42             ]
43           }
44         }
45       }
46     ],
47     "load_balance_models": [
48       {
49         "model": "string",
50         "weight": 1.1,
51         "credentials": {}
52       }
53     ],
54     "thinking": {
55       "type": "enabled",
56       "budget_tokens": 1
57     },
58     "tool_choice": "string",
59     "response_format": {},
60     "json_schema": {},
61     "is_deployed": true,
62     "prompt_version_id": "string",
63     "description": "string",
64     "created_at": "2024-01-15T09:30:00Z",
65     "version": 1,
66     "model": "string",
67     "stream": true,
68     "temperature": 1.1,
69     "max_tokens": 1,
70     "top_p": 1.1,
71     "frequency_penalty": 1.1,
72     "presence_penalty": 1.1,
73     "reasoning_effort": "string",
74     "verbosity": "string",
75     "seed": 1,
76     "readonly": true,
77     "fallback_models": [
78       "string"
79     ],
80     "is_enforcing_response_format": true
81   },
82   "full_prompt_id": "string",
83   "created_by": 1,
84   "tags": [
85     {
86       "id": "string",
87       "name": "string",
88       "color": "string",
89       "created_at": "2024-01-15T09:30:00Z",
90       "updated_at": "2024-01-15T09:30:00Z"
91     }
92   ],
93   "prompt_versions": [
94     {
95       "id": 1,
96       "edited_by": {
97         "id": 1,
98         "email": "string",
99         "name": "string",
100         "username": "string",
101         "first_name": "string",
102         "last_name": "string"
103       },
104       "updated_at": "2024-01-15T09:30:00Z",
105       "prompt": 1,
106       "parent_prompt": "string",
107       "messages": [
108         {
109           "role": "string",
110           "content": "string",
111           "id": "string",
112           "model": "string",
113           "tool_calls": [
114             {}
115           ],
116           "tool_call_id": "string"
117         }
118       ],
119       "variables": {},
120       "tools": [
121         {
122           "type": "function",
123           "function": {
124             "name": "string",
125             "description": "string",
126             "strict": true,
127             "additionalProperties": true,
128             "parameters": {
129               "type": "object",
130               "properties": {},
131               "required": [
132                 "string"
133               ]
134             }
135           }
136         }
137       ],
138       "load_balance_models": [
139         {
140           "model": "string",
141           "weight": 1.1,
142           "credentials": {}
143         }
144       ],
145       "thinking": {
146         "type": "enabled",
147         "budget_tokens": 1
148       },
149       "tool_choice": "string",
150       "response_format": {},
151       "json_schema": {},
152       "is_deployed": true,
153       "prompt_version_id": "string",
154       "description": "string",
155       "created_at": "2024-01-15T09:30:00Z",
156       "version": 1,
157       "model": "string",
158       "stream": true,
159       "temperature": 1.1,
160       "max_tokens": 1,
161       "top_p": 1.1,
162       "frequency_penalty": 1.1,
163       "presence_penalty": 1.1,
164       "reasoning_effort": "string",
165       "verbosity": "string",
166       "seed": 1,
167       "readonly": true,
168       "fallback_models": [
169         "string"
170       ],
171       "is_enforcing_response_format": true
172     }
173   ],
174   "live_version": {
175     "id": 1,
176     "edited_by": {
177       "id": 1,
178       "email": "string",
179       "name": "string",
180       "username": "string",
181       "first_name": "string",
182       "last_name": "string"
183     },
184     "updated_at": "2024-01-15T09:30:00Z",
185     "prompt": 1,
186     "parent_prompt": "string",
187     "messages": [
188       {
189         "role": "string",
190         "content": "string",
191         "id": "string",
192         "model": "string",
193         "tool_calls": [
194           {}
195         ],
196         "tool_call_id": "string"
197       }
198     ],
199     "variables": {},
200     "tools": [
201       {
202         "type": "function",
203         "function": {
204           "name": "string",
205           "description": "string",
206           "strict": true,
207           "additionalProperties": true,
208           "parameters": {
209             "type": "object",
210             "properties": {},
211             "required": [
212               "string"
213             ]
214           }
215         }
216       }
217     ],
218     "load_balance_models": [
219       {
220         "model": "string",
221         "weight": 1.1,
222         "credentials": {}
223       }
224     ],
225     "thinking": {
226       "type": "enabled",
227       "budget_tokens": 1
228     },
229     "tool_choice": "string",
230     "response_format": {},
231     "json_schema": {},
232     "is_deployed": true,
233     "prompt_version_id": "string",
234     "description": "string",
235     "created_at": "2024-01-15T09:30:00Z",
236     "version": 1,
237     "model": "string",
238     "stream": true,
239     "temperature": 1.1,
240     "max_tokens": 1,
241     "top_p": 1.1,
242     "frequency_penalty": 1.1,
243     "presence_penalty": 1.1,
244     "reasoning_effort": "string",
245     "verbosity": "string",
246     "seed": 1,
247     "readonly": true,
248     "fallback_models": [
249       "string"
250     ],
251     "is_enforcing_response_format": true
252   },
253   "commit_count": 1,
254   "organization": 1,
255   "project": "string",
256   "name": "string",
257   "description": "string",
258   "prompt_id": "string",
259   "prompt_slug": "string",
260   "starred": true,
261   "deleted_at": "2024-01-15T09:30:00Z"
262 }

POST handler with superadmin-only field protection.

Strips superadmin-only fields from non-superadmin requests before delegating to OrganizationInjectionMixin.post() for org injection.

Authentication

AuthorizationBearer

JWT access token or Respan API key

Path parameters

idintegerRequired

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

idintegerRead-only

current_versionobject

full_prompt_idstringRead-only

created_byintegerRead-only

tagslist of objectsRead-only

prompt_versionslist of objectsRead-only

live_versionobject

commit_countintegerRead-only

organizationinteger

projectstring or null

namestring<=100 characters

descriptionstring

prompt_idstring<=70 characters

prompt_slugstring or null<=100 characters

starredboolean

deleted_atdatetime or null