Api Prompts Partial Update

PATCH

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

PATCH

/api/prompts/

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

200Updated

1 {
2   "id": "string",
3   "current_version": {
4     "id": "string",
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     "prompt_version_id": "string",
14     "updated_at": "2024-01-15T09:30:00Z",
15     "prompt": 1,
16     "parent_prompt": "string",
17     "messages": [
18       {
19         "role": "string",
20         "content": "string",
21         "id": "string",
22         "model": "string",
23         "tool_calls": [
24           {}
25         ],
26         "tool_call_id": "string"
27       }
28     ],
29     "variables": {},
30     "tools": [
31       {
32         "type": "function",
33         "function": {
34           "name": "string",
35           "description": "string",
36           "strict": true,
37           "additionalProperties": true,
38           "parameters": {
39             "type": "object",
40             "properties": {},
41             "required": [
42               "string"
43             ]
44           }
45         }
46       }
47     ],
48     "load_balance_models": [
49       {
50         "model": "string",
51         "weight": 1.1,
52         "credentials": {}
53       }
54     ],
55     "thinking": {
56       "type": "enabled",
57       "budget_tokens": 1
58     },
59     "tool_choice": "string",
60     "response_format": {},
61     "json_schema": {},
62     "is_deployed": true,
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_live_version_number": 1,
94   "live_version": {
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   "commit_count": 1,
174   "organization": 1,
175   "project": "string",
176   "name": "string",
177   "description": "string",
178   "prompt_id": "string",
179   "prompt_slug": "string",
180   "starred": true,
181   "deleted_at": "2024-01-15T09:30:00Z"
182 }

PATCH handler with superadmin lock and field protection.

Checks:

Object lock (is_managed=True -> non-superadmins can’t modify)
Field protection (non-superadmins can’t modify specific fields)

Authentication

AuthorizationBearer

JWT access token or Respan API key

Request

This endpoint expects an object.

projectstring or nullOptional>=1 character

namestringOptional1-100 characters

descriptionstringOptional

prompt_idstringOptional<=70 characters

prompt_slugstring or nullOptional<=100 characters

starredbooleanOptional

deleted_atdatetime or nullOptional

organizationintegerOptional

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 null

namestring<=100 characters

descriptionstring

prompt_idstring<=70 characters

prompt_slugstring or null<=100 characters

starredboolean

deleted_atdatetime or null