Run Deployment Now changedapi/beta/deployments/run
Nearest release: v2.1.245, published 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+36added
Lines−75removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits18to this page, all time
# Run Deployment Now ## Path parameters ## Headers ## Returns ## Example ### Response (200) ## Run Deployment Now ### Path Parameters ### Header Parameters ### Returns ### Example #### Response
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---
1# Run Deployment Now
52
6## Run Deployment Now
3**POST** `/v1/deployments/{deployment_id}/run`
74
8**post** `/v1/deployments/{deployment_id}/run`
9
105Run Deployment Now
116
12### Path Parameters
7## Path parameters
138
149- `deployment_id: string`
1510
16### Header Parameters
11## Headers
1712
1813- `"anthropic-beta": optional array of AnthropicBeta`
1914
from line 86
9186
9287 - `"mid-conversation-tool-changes-2026-07-01"`
9388
94### Returns
89## Returns
9590
96- `BetaManagedAgentsDeploymentRun object { id, agent, created_at, 5 more }`
91- `BetaManagedAgentsDeploymentRun object`
9792
9893 A persistent, append-only record of a single deployment execution. Records session creation success or failure — no session lifecycle tracking.
9994
from line 104
109104
110105 - `type: "agent"`
111106
112 - `"agent"`
113
114107 - `version: number`
115108
109 format: int32
110
116111 - `created_at: string`
117112
118113 A timestamp in RFC 3339 format
119114
115 format: date-time
116
120117 - `deployment_id: string`
121118
122119 ID of the deployment that produced this run.
from line 122
125122
126123 Why the run failed to create a session. The type identifies the failure; message is human-readable detail.
127124
128 - `BetaManagedAgentsEnvironmentArchivedRunError object { message, type }`
125 - `BetaManagedAgentsEnvironmentArchivedRunError object`
129126
130127 The deployment's environment was archived.
131128
from line 132
135132
136133 - `type: "environment_archived_error"`
137134
138 - `"environment_archived_error"`
135 - `BetaManagedAgentsAgentArchivedRunError object`
139136
140 - `BetaManagedAgentsAgentArchivedRunError object { message, type }`
141
142137 The deployment's agent was archived.
143138
144139 - `message: string`
from line 142
147142
148143 - `type: "agent_archived_error"`
149144
150 - `"agent_archived_error"`
145 - `BetaManagedAgentsEnvironmentNotFoundRunError object`
151146
152 - `BetaManagedAgentsEnvironmentNotFoundRunError object { message, type }`
153
154147 The deployment's environment no longer exists.
155148
156149 - `message: string`
from line 152
159152
160153 - `type: "environment_not_found_error"`
161154
162 - `"environment_not_found_error"`
155 - `BetaManagedAgentsVaultNotFoundRunError object`
163156
164 - `BetaManagedAgentsVaultNotFoundRunError object { message, type }`
165
166157 A vault referenced by the deployment no longer exists.
167158
168159 - `message: string`
from line 162
171162
172163 - `type: "vault_not_found_error"`
173164
174 - `"vault_not_found_error"`
165 - `BetaManagedAgentsVaultArchivedRunError object`
175166
176 - `BetaManagedAgentsVaultArchivedRunError object { message, type }`
177
178167 A vault referenced by the deployment is archived.
179168
180169 - `message: string`
from line 172
183172
184173 - `type: "vault_archived_error"`
185174
186 - `"vault_archived_error"`
175 - `BetaManagedAgentsFileNotFoundRunError object`
187176
188 - `BetaManagedAgentsFileNotFoundRunError object { message, type }`
189
190177 A file resource referenced by the deployment no longer exists.
191178
192179 - `message: string`
from line 182
195182
196183 - `type: "file_not_found_error"`
197184
198 - `"file_not_found_error"`
185 - `BetaManagedAgentsMemoryStoreArchivedRunError object`
199186
200 - `BetaManagedAgentsMemoryStoreArchivedRunError object { message, type }`
201
202187 A memory store referenced by the deployment is archived.
203188
204189 - `message: string`
from line 192
207192
208193 - `type: "memory_store_archived_error"`
209194
210 - `"memory_store_archived_error"`
195 - `BetaManagedAgentsSkillNotFoundRunError object`
211196
212 - `BetaManagedAgentsSkillNotFoundRunError object { message, type }`
213
214197 A skill referenced by the deployment's agent no longer exists.
215198
216199 - `message: string`
from line 202
219202
220203 - `type: "skill_not_found_error"`
221204
222 - `"skill_not_found_error"`
205 - `BetaManagedAgentsSessionResourceNotFoundRunError object`
223206
224 - `BetaManagedAgentsSessionResourceNotFoundRunError object { message, type }`
225
226207 A referenced resource no longer exists and its kind was not reported.
227208
228209 - `message: string`
from line 212
231212
232213 - `type: "session_resource_not_found_error"`
233214
234 - `"session_resource_not_found_error"`
215 - `BetaManagedAgentsWorkspaceArchivedRunError object`
235216
236 - `BetaManagedAgentsWorkspaceArchivedRunError object { message, type }`
237
238217 The deployment's workspace was archived.
239218
240219 - `message: string`
from line 222
243222
244223 - `type: "workspace_archived_error"`
245224
246 - `"workspace_archived_error"`
225 - `BetaManagedAgentsOrganizationDisabledRunError object`
247226
248 - `BetaManagedAgentsOrganizationDisabledRunError object { message, type }`
249
250227 The deployment's organization is disabled.
251228
252229 - `message: string`
from line 232
255232
256233 - `type: "organization_disabled_error"`
257234
258 - `"organization_disabled_error"`
235 - `BetaManagedAgentsSessionRateLimitedRunError object`
259236
260 - `BetaManagedAgentsSessionRateLimitedRunError object { message, type }`
261
262237 Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.
263238
264239 - `message: string`
from line 242
267242
268243 - `type: "session_rate_limited_error"`
269244
270 - `"session_rate_limited_error"`
245 - `BetaManagedAgentsSessionCreationRejectedRunError object`
271246
272 - `BetaManagedAgentsSessionCreationRejectedRunError object { message, type }`
273
274247 The session create request was rejected with a non-retryable validation error.
275248
276249 - `message: string`
from line 252
279252
280253 - `type: "session_creation_rejected_error"`
281254
282 - `"session_creation_rejected_error"`
255 - `BetaManagedAgentsUnknownRunError object`
283256
284 - `BetaManagedAgentsUnknownRunError object { message, type }`
285
286257 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.
287258
288259 - `message: string`
from line 262
291262
292263 - `type: "unknown_error"`
293264
294 - `"unknown_error"`
265 - `BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object`
295266
296 - `BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object { message, type }`
297
298267 The deployment configures resources, but its environment is self-hosted and cannot mount them.
299268
300269 - `message: string`
from line 272
303272
304273 - `type: "self_hosted_resources_unsupported_error"`
305274
306 - `"self_hosted_resources_unsupported_error"`
275 - `BetaManagedAgentsMCPEgressBlockedRunError object`
307276
308 - `BetaManagedAgentsMCPEgressBlockedRunError object { message, type }`
309
310277 An MCP server host used by the deployment's agent is blocked by the environment's network policy.
311278
312279 - `message: string`
from line 282
315282
316283 - `type: "mcp_egress_blocked_error"`
317284
318 - `"mcp_egress_blocked_error"`
319
320285 - `session_id: string or null`
321286
322287 Populated on success. Null on creation failure. Exactly one of session_id or error is non-null.
from line 290
325290
326291 Describes what triggered a deployment run, with trigger-specific metadata.
327292
328 - `BetaManagedAgentsScheduleTriggerContext object { scheduled_at, type }`
293 - `BetaManagedAgentsScheduleTriggerContext object`
329294
330295 The run was fired by the deployment's cron schedule.
331296
from line 298
333298
334299 A timestamp in RFC 3339 format
335300
301 format: date-time
302
336303 - `type: "schedule"`
337304
338 - `"schedule"`
305 - `BetaManagedAgentsManualTriggerContext object`
339306
340 - `BetaManagedAgentsManualTriggerContext object { type }`
341
342307 The run was started manually by creating a session directly against the deployment.
343308
344309 - `type: "manual"`
345310
346 - `"manual"`
347
348311 - `type: "deployment_run"`
349312
350 - `"deployment_run"`
313## Example
351314
352### Example
353
354```http
315```bash
355316curl https://api.anthropic.com/v1/deployments/$DEPLOYMENT_ID/run \
356317 -X POST \
357318 -H 'anthropic-version: 2023-06-01' \
from line 320
359320 -H "X-Api-Key: $ANTHROPIC_API_KEY"
360321```
361322
362#### Response
323### Response (200)
363324
364325```json
365326{
No line in this hunk matches that.