The whole hunk
from line 1, old and new numbered
/
lines
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