List Deployment Runs changedapi/beta/deployment_runs/list
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+44added
Lines−73removed
From line
1
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits17to this page, all time
# List Deployment Runs ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## List Deployment Runs ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
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---
1# List Deployment Runs
52
6## List Deployment Runs
3**GET** `/v1/deployment_runs`
74
8**get** `/v1/deployment_runs`
9
105List Deployment Runs
116
12### Query Parameters
7## Query parameters
138
149- `"created_at[gt]": optional string`
1510
1611 Return runs created strictly after this time (exclusive).
1712
13 format: date-time
14
1815- `"created_at[gte]": optional string`
1916
2017 Return runs created at or after this time (inclusive).
2118
19 format: date-time
20
2221- `"created_at[lt]": optional string`
2322
2423 Return runs created strictly before this time (exclusive).
2524
25 format: date-time
26
2627- `"created_at[lte]": optional string`
2728
2829 Return runs created at or before this time (inclusive).
2930
31 format: date-time
32
3033- `deployment_id: optional string`
3134
3235 Filter to a specific deployment. Omit to list across all deployments in the workspace. Filtering by a non-existent deployment_id returns 200 with empty data.
from line 42
3942
4043 Maximum results per page. Default 20, maximum 1000.
4144
45 format: int32
46
4247- `page: optional string`
4348
4449 Opaque pagination cursor. Pass next_page from the previous response. Invalid or expired cursors return 400.
from line 56
5156
5257 - `"manual"`
5358
54### Header Parameters
59## Headers
5560
5661- `"anthropic-beta": optional array of AnthropicBeta`
5762
from line 134
129134
130135 - `"mid-conversation-tool-changes-2026-07-01"`
131136
132### Returns
137## Returns
133138
134139- `data: array of BetaManagedAgentsDeploymentRun`
135140
from line 152
147152
148153 - `type: "agent"`
149154
150 - `"agent"`
151
152155 - `version: number`
153156
157 format: int32
158
154159 - `created_at: string`
155160
156161 A timestamp in RFC 3339 format
157162
163 format: date-time
164
158165 - `deployment_id: string`
159166
160167 ID of the deployment that produced this run.
from line 170
163170
164171 Why the run failed to create a session. The type identifies the failure; message is human-readable detail.
165172
166 - `BetaManagedAgentsEnvironmentArchivedRunError object { message, type }`
173 - `BetaManagedAgentsEnvironmentArchivedRunError object`
167174
168175 The deployment's environment was archived.
169176
from line 180
173180
174181 - `type: "environment_archived_error"`
175182
176 - `"environment_archived_error"`
183 - `BetaManagedAgentsAgentArchivedRunError object`
177184
178 - `BetaManagedAgentsAgentArchivedRunError object { message, type }`
179
180185 The deployment's agent was archived.
181186
182187 - `message: string`
from line 190
185190
186191 - `type: "agent_archived_error"`
187192
188 - `"agent_archived_error"`
193 - `BetaManagedAgentsEnvironmentNotFoundRunError object`
189194
190 - `BetaManagedAgentsEnvironmentNotFoundRunError object { message, type }`
191
192195 The deployment's environment no longer exists.
193196
194197 - `message: string`
from line 200
197200
198201 - `type: "environment_not_found_error"`
199202
200 - `"environment_not_found_error"`
203 - `BetaManagedAgentsVaultNotFoundRunError object`
201204
202 - `BetaManagedAgentsVaultNotFoundRunError object { message, type }`
203
204205 A vault referenced by the deployment no longer exists.
205206
206207 - `message: string`
from line 210
209210
210211 - `type: "vault_not_found_error"`
211212
212 - `"vault_not_found_error"`
213 - `BetaManagedAgentsVaultArchivedRunError object`
213214
214 - `BetaManagedAgentsVaultArchivedRunError object { message, type }`
215
216215 A vault referenced by the deployment is archived.
217216
218217 - `message: string`
from line 220
221220
222221 - `type: "vault_archived_error"`
223222
224 - `"vault_archived_error"`
223 - `BetaManagedAgentsFileNotFoundRunError object`
225224
226 - `BetaManagedAgentsFileNotFoundRunError object { message, type }`
227
228225 A file resource referenced by the deployment no longer exists.
229226
230227 - `message: string`
from line 230
233230
234231 - `type: "file_not_found_error"`
235232
236 - `"file_not_found_error"`
233 - `BetaManagedAgentsMemoryStoreArchivedRunError object`
237234
238 - `BetaManagedAgentsMemoryStoreArchivedRunError object { message, type }`
239
240235 A memory store referenced by the deployment is archived.
241236
242237 - `message: string`
from line 240
245240
246241 - `type: "memory_store_archived_error"`
247242
248 - `"memory_store_archived_error"`
243 - `BetaManagedAgentsSkillNotFoundRunError object`
249244
250 - `BetaManagedAgentsSkillNotFoundRunError object { message, type }`
251
252245 A skill referenced by the deployment's agent no longer exists.
253246
254247 - `message: string`
from line 250
257250
258251 - `type: "skill_not_found_error"`
259252
260 - `"skill_not_found_error"`
253 - `BetaManagedAgentsSessionResourceNotFoundRunError object`
261254
262 - `BetaManagedAgentsSessionResourceNotFoundRunError object { message, type }`
263
264255 A referenced resource no longer exists and its kind was not reported.
265256
266257 - `message: string`
from line 260
269260
270261 - `type: "session_resource_not_found_error"`
271262
272 - `"session_resource_not_found_error"`
263 - `BetaManagedAgentsWorkspaceArchivedRunError object`
273264
274 - `BetaManagedAgentsWorkspaceArchivedRunError object { message, type }`
275
276265 The deployment's workspace was archived.
277266
278267 - `message: string`
from line 270
281270
282271 - `type: "workspace_archived_error"`
283272
284 - `"workspace_archived_error"`
273 - `BetaManagedAgentsOrganizationDisabledRunError object`
285274
286 - `BetaManagedAgentsOrganizationDisabledRunError object { message, type }`
287
288275 The deployment's organization is disabled.
289276
290277 - `message: string`
from line 280
293280
294281 - `type: "organization_disabled_error"`
295282
296 - `"organization_disabled_error"`
283 - `BetaManagedAgentsSessionRateLimitedRunError object`
297284
298 - `BetaManagedAgentsSessionRateLimitedRunError object { message, type }`
299
300285 Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.
301286
302287 - `message: string`
from line 290
305290
306291 - `type: "session_rate_limited_error"`
307292
308 - `"session_rate_limited_error"`
293 - `BetaManagedAgentsSessionCreationRejectedRunError object`
309294
310 - `BetaManagedAgentsSessionCreationRejectedRunError object { message, type }`
311
312295 The session create request was rejected with a non-retryable validation error.
313296
314297 - `message: string`
from line 300
317300
318301 - `type: "session_creation_rejected_error"`
319302
320 - `"session_creation_rejected_error"`
303 - `BetaManagedAgentsUnknownRunError object`
321304
322 - `BetaManagedAgentsUnknownRunError object { message, type }`
323
324305 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.
325306
326307 - `message: string`
from line 310
329310
330311 - `type: "unknown_error"`
331312
332 - `"unknown_error"`
313 - `BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object`
333314
334 - `BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object { message, type }`
335
336315 The deployment configures resources, but its environment is self-hosted and cannot mount them.
337316
338317 - `message: string`
from line 320
341320
342321 - `type: "self_hosted_resources_unsupported_error"`
343322
344 - `"self_hosted_resources_unsupported_error"`
323 - `BetaManagedAgentsMCPEgressBlockedRunError object`
345324
346 - `BetaManagedAgentsMCPEgressBlockedRunError object { message, type }`
347
348325 An MCP server host used by the deployment's agent is blocked by the environment's network policy.
349326
350327 - `message: string`
from line 330
353330
354331 - `type: "mcp_egress_blocked_error"`
355332
356 - `"mcp_egress_blocked_error"`
357
358333 - `session_id: string or null`
359334
360335 Populated on success. Null on creation failure. Exactly one of session_id or error is non-null.
from line 338
363338
364339 Describes what triggered a deployment run, with trigger-specific metadata.
365340
366 - `BetaManagedAgentsScheduleTriggerContext object { scheduled_at, type }`
341 - `BetaManagedAgentsScheduleTriggerContext object`
367342
368343 The run was fired by the deployment's cron schedule.
369344
from line 346
371346
372347 A timestamp in RFC 3339 format
373348
349 format: date-time
350
374351 - `type: "schedule"`
375352
376 - `"schedule"`
353 - `BetaManagedAgentsManualTriggerContext object`
377354
378 - `BetaManagedAgentsManualTriggerContext object { type }`
379
380355 The run was started manually by creating a session directly against the deployment.
381356
382357 - `type: "manual"`
383358
384 - `"manual"`
385
386359 - `type: "deployment_run"`
387360
388 - `"deployment_run"`
389
390361- `next_page: optional string or null`
391362
392363 Opaque cursor for the next page. Null when no more results.
393364
394### Example
365## Example
395366
396```http
367```bash
397368curl https://api.anthropic.com/v1/deployment_runs \
398369 -H 'anthropic-version: 2023-06-01' \
399370 -H 'anthropic-beta: managed-agents-2026-04-01' \
from line 371
400371 -H "X-Api-Key: $ANTHROPIC_API_KEY"
401372```
402373
403#### Response
374### Response (200)
404375
405376```json
406377{
No line in this hunk matches that.