List Deployment Runs changedapi/beta/deployment_runs/list
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: List Deployment Runs
3url: https://platform.claude.com/docs/en/api/beta/deployment_runs/list
4---
5
16# List Deployment Runs
27
38**GET** `/v1/deployment_runs`
from line 69
6469
6570 - `string`
6671
67 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 41 more`
72 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 42 more`
6873
6974 - `"message-batches-2024-09-24"`
7075
from line 117
112117
113118 - `"user-profiles-2026-08-18"`
114119
120 - `"user-profiles-2026-09-04"`
121
115122 - `"advisor-tool-2026-03-01"`
116123
117124 - `"managed-agents-2026-04-01"`
from line 161
154161
155162 - `"mid-conversation-system-clear-at-2026-08-21"`
156163
164- `"anthropic-workspace-id": optional string`
165
157166## Returns
158167
159168- `data: array of BetaManagedAgentsDeploymentRun`
from line 169
160169
161170 List of deployment runs.
162171
172 - `type: "deployment_run"`
173
163174 - `id: string`
164175
165176 Unique identifier for this run (`drun_...`).
from line 179
168179
169180 A resolved agent reference with a concrete version.
170181
171 - `id: string`
172
173182 - `type: "agent"`
174183
184 - `id: string`
185
175186 - `version: number`
176187
177188 format: int32
from line 205
194205
195206 The deployment's environment was archived.
196207
208 - `type: "environment_archived_error"`
209
197210 - `message: string`
198211
199212 Human-readable error description.
200213
201 - `type: "environment_archived_error"`
202
203214 - `BetaManagedAgentsAgentArchivedRunError object`
204215
205216 The deployment's agent was archived.
206217
218 - `type: "agent_archived_error"`
219
207220 - `message: string`
208221
209222 Human-readable error description.
210223
211 - `type: "agent_archived_error"`
212
213224 - `BetaManagedAgentsEnvironmentNotFoundRunError object`
214225
215226 The deployment's environment no longer exists.
216227
228 - `type: "environment_not_found_error"`
229
217230 - `message: string`
218231
219232 Human-readable error description.
220233
221 - `type: "environment_not_found_error"`
222
223234 - `BetaManagedAgentsVaultNotFoundRunError object`
224235
225236 A vault referenced by the deployment no longer exists.
226237
238 - `type: "vault_not_found_error"`
239
227240 - `message: string`
228241
229242 Human-readable error description.
230243
231 - `type: "vault_not_found_error"`
232
233244 - `BetaManagedAgentsVaultArchivedRunError object`
234245
235246 A vault referenced by the deployment is archived.
236247
248 - `type: "vault_archived_error"`
249
237250 - `message: string`
238251
239252 Human-readable error description.
240253
241 - `type: "vault_archived_error"`
242
243254 - `BetaManagedAgentsFileNotFoundRunError object`
244255
245256 A file resource referenced by the deployment no longer exists.
246257
258 - `type: "file_not_found_error"`
259
247260 - `message: string`
248261
249262 Human-readable error description.
250263
251 - `type: "file_not_found_error"`
252
253264 - `BetaManagedAgentsMemoryStoreArchivedRunError object`
254265
255266 A memory store referenced by the deployment is archived.
256267
268 - `type: "memory_store_archived_error"`
269
257270 - `message: string`
258271
259272 Human-readable error description.
260273
261 - `type: "memory_store_archived_error"`
262
263274 - `BetaManagedAgentsSkillNotFoundRunError object`
264275
265276 A skill referenced by the deployment's agent no longer exists.
266277
278 - `type: "skill_not_found_error"`
279
267280 - `message: string`
268281
269282 Human-readable error description.
270283
271 - `type: "skill_not_found_error"`
272
273284 - `BetaManagedAgentsSessionResourceNotFoundRunError object`
274285
275286 A referenced resource no longer exists and its kind was not reported.
276287
288 - `type: "session_resource_not_found_error"`
289
277290 - `message: string`
278291
279292 Human-readable error description.
280293
281 - `type: "session_resource_not_found_error"`
282
283294 - `BetaManagedAgentsWorkspaceArchivedRunError object`
284295
285296 The deployment's workspace was archived.
286297
298 - `type: "workspace_archived_error"`
299
287300 - `message: string`
288301
289302 Human-readable error description.
290303
291 - `type: "workspace_archived_error"`
292
293304 - `BetaManagedAgentsOrganizationDisabledRunError object`
294305
295306 The deployment's organization is disabled.
296307
308 - `type: "organization_disabled_error"`
309
297310 - `message: string`
298311
299312 Human-readable error description.
300313
301 - `type: "organization_disabled_error"`
302
303314 - `BetaManagedAgentsSessionRateLimitedRunError object`
304315
305316 Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.
306317
318 - `type: "session_rate_limited_error"`
319
307320 - `message: string`
308321
309322 Human-readable error description.
310323
311 - `type: "session_rate_limited_error"`
312
313324 - `BetaManagedAgentsSessionCreationRejectedRunError object`
314325
315326 The session create request was rejected with a non-retryable validation error.
316327
328 - `type: "session_creation_rejected_error"`
329
317330 - `message: string`
318331
319332 Human-readable error description.
320333
321 - `type: "session_creation_rejected_error"`
322
323334 - `BetaManagedAgentsUnknownRunError object`
324335
325336 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.
326337
338 - `type: "unknown_error"`
339
327340 - `message: string`
328341
329342 Human-readable error description.
330343
331 - `type: "unknown_error"`
332
333344 - `BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object`
334345
335346 The deployment configures resources, but its environment is self-hosted and cannot mount them.
336347
348 - `type: "self_hosted_resources_unsupported_error"`
349
337350 - `message: string`
338351
339352 Human-readable error description.
340353
341 - `type: "self_hosted_resources_unsupported_error"`
342
343354 - `BetaManagedAgentsMCPEgressBlockedRunError object`
344355
345356 An MCP server host used by the deployment's agent is blocked by the environment's network policy.
346357
358 - `type: "mcp_egress_blocked_error"`
359
347360 - `message: string`
348361
349362 Human-readable error description.
350363
351 - `type: "mcp_egress_blocked_error"`
352
353364 - `session_id: string or null`
354365
355366 Populated on success. Null on creation failure. Exactly one of `session_id` or `error` is non-null.
from line 373
362373
363374 The run was fired by the deployment's cron schedule.
364375
376 - `type: "schedule"`
377
365378 - `scheduled_at: string`
366379
367380 A timestamp in RFC 3339 format
from line 381
368381
369382 format: date-time
370383
371 - `type: "schedule"`
372
373384 - `BetaManagedAgentsManualTriggerContext object`
374385
375386 The run was started manually by creating a session directly against the deployment.
376387
377388 - `type: "manual"`
378
379 - `type: "deployment_run"`
380389
381390- `next_page: optional string or null`
382391
No line in this hunk matches that.