Run Deployment Now changedapi/beta/deployments/run
Nearest release: v2.1.268, published under an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
Recorded here
Lines+80added
Lines−71removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits20to this page, all time
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: Run Deployment Now
3url: https://platform.claude.com/docs/en/api/beta/deployments/run
4---
5
16# Run Deployment Now
27
38**POST** `/v1/deployments/{deployment_id}/run`
from line 21
1621
1722 - `string`
1823
19 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
24 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
2025
2126 - `"message-batches-2024-09-24"`
2227
from line 69
6469
6570 - `"user-profiles-2026-08-18"`
6671
72 - `"user-profiles-2026-09-04"`
73
6774 - `"advisor-tool-2026-03-01"`
6875
6976 - `"managed-agents-2026-04-01"`
from line 113
106113
107114 - `"mid-conversation-system-clear-at-2026-08-21"`
108115
116- `"anthropic-workspace-id": optional string`
117
109118## Returns
110119
111120- `BetaManagedAgentsDeploymentRun object`
from line 121
112121
113122 A persistent, append-only record of a single deployment execution. Records session creation success or failure — no session lifecycle tracking.
114123
124 - `type: "deployment_run"`
125
115126 - `id: string`
116127
117128 Unique identifier for this run (`drun_...`).
from line 131
120131
121132 A resolved agent reference with a concrete version.
122133
123 - `id: string`
124
125134 - `type: "agent"`
126135
136 - `id: string`
137
127138 - `version: number`
128139
129140 format: int32
from line 157
146157
147158 The deployment's environment was archived.
148159
160 - `type: "environment_archived_error"`
161
149162 - `message: string`
150163
151164 Human-readable error description.
152165
153 - `type: "environment_archived_error"`
154
155166 - `BetaManagedAgentsAgentArchivedRunError object`
156167
157168 The deployment's agent was archived.
158169
170 - `type: "agent_archived_error"`
171
159172 - `message: string`
160173
161174 Human-readable error description.
162175
163 - `type: "agent_archived_error"`
164
165176 - `BetaManagedAgentsEnvironmentNotFoundRunError object`
166177
167178 The deployment's environment no longer exists.
168179
180 - `type: "environment_not_found_error"`
181
169182 - `message: string`
170183
171184 Human-readable error description.
172185
173 - `type: "environment_not_found_error"`
174
175186 - `BetaManagedAgentsVaultNotFoundRunError object`
176187
177188 A vault referenced by the deployment no longer exists.
178189
190 - `type: "vault_not_found_error"`
191
179192 - `message: string`
180193
181194 Human-readable error description.
182195
183 - `type: "vault_not_found_error"`
184
185196 - `BetaManagedAgentsVaultArchivedRunError object`
186197
187198 A vault referenced by the deployment is archived.
188199
200 - `type: "vault_archived_error"`
201
189202 - `message: string`
190203
191204 Human-readable error description.
192205
193 - `type: "vault_archived_error"`
194
195206 - `BetaManagedAgentsFileNotFoundRunError object`
196207
197208 A file resource referenced by the deployment no longer exists.
198209
210 - `type: "file_not_found_error"`
211
199212 - `message: string`
200213
201214 Human-readable error description.
202215
203 - `type: "file_not_found_error"`
204
205216 - `BetaManagedAgentsMemoryStoreArchivedRunError object`
206217
207218 A memory store referenced by the deployment is archived.
208219
220 - `type: "memory_store_archived_error"`
221
209222 - `message: string`
210223
211224 Human-readable error description.
212225
213 - `type: "memory_store_archived_error"`
214
215226 - `BetaManagedAgentsSkillNotFoundRunError object`
216227
217228 A skill referenced by the deployment's agent no longer exists.
218229
230 - `type: "skill_not_found_error"`
231
219232 - `message: string`
220233
221234 Human-readable error description.
222235
223 - `type: "skill_not_found_error"`
224
225236 - `BetaManagedAgentsSessionResourceNotFoundRunError object`
226237
227238 A referenced resource no longer exists and its kind was not reported.
228239
240 - `type: "session_resource_not_found_error"`
241
229242 - `message: string`
230243
231244 Human-readable error description.
232245
233 - `type: "session_resource_not_found_error"`
234
235246 - `BetaManagedAgentsWorkspaceArchivedRunError object`
236247
237248 The deployment's workspace was archived.
238249
250 - `type: "workspace_archived_error"`
251
239252 - `message: string`
240253
241254 Human-readable error description.
242255
243 - `type: "workspace_archived_error"`
244
245256 - `BetaManagedAgentsOrganizationDisabledRunError object`
246257
247258 The deployment's organization is disabled.
248259
260 - `type: "organization_disabled_error"`
261
249262 - `message: string`
250263
251264 Human-readable error description.
252265
253 - `type: "organization_disabled_error"`
254
255266 - `BetaManagedAgentsSessionRateLimitedRunError object`
256267
257268 Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.
258269
270 - `type: "session_rate_limited_error"`
271
259272 - `message: string`
260273
261274 Human-readable error description.
262275
263 - `type: "session_rate_limited_error"`
264
265276 - `BetaManagedAgentsSessionCreationRejectedRunError object`
266277
267278 The session create request was rejected with a non-retryable validation error.
268279
280 - `type: "session_creation_rejected_error"`
281
269282 - `message: string`
270283
271284 Human-readable error description.
272285
273 - `type: "session_creation_rejected_error"`
274
275286 - `BetaManagedAgentsUnknownRunError object`
276287
277288 An unknown or unexpected error caused the run to fail. A fallback variant; clients that do not recognize a new error type can match on message alone.
278289
290 - `type: "unknown_error"`
291
279292 - `message: string`
280293
281294 Human-readable error description.
282295
283 - `type: "unknown_error"`
284
285296 - `BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object`
286297
287298 The deployment configures resources, but its environment is self-hosted and cannot mount them.
288299
300 - `type: "self_hosted_resources_unsupported_error"`
301
289302 - `message: string`
290303
291304 Human-readable error description.
292305
293 - `type: "self_hosted_resources_unsupported_error"`
294
295306 - `BetaManagedAgentsMCPEgressBlockedRunError object`
296307
297308 An MCP server host used by the deployment's agent is blocked by the environment's network policy.
298309
310 - `type: "mcp_egress_blocked_error"`
311
299312 - `message: string`
300313
301314 Human-readable error description.
302315
303 - `type: "mcp_egress_blocked_error"`
304
305316 - `session_id: string or null`
306317
307318 Populated on success. Null on creation failure. Exactly one of `session_id` or `error` is non-null.
from line 325
314325
315326 The run was fired by the deployment's cron schedule.
316327
328 - `type: "schedule"`
329
317330 - `scheduled_at: string`
318331
319332 A timestamp in RFC 3339 format
from line 333
320333
321334 format: date-time
322335
323 - `type: "schedule"`
324
325336 - `BetaManagedAgentsManualTriggerContext object`
326337
327338 The run was started manually by creating a session directly against the deployment.
328339
329340 - `type: "manual"`
330
331 - `type: "deployment_run"`
332341
333342## Example
334343
No line in this hunk matches that.