List Deployments changedapi/beta/deployments/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+95added
Lines−140removed
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
# List Deployments ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## List Deployments ### Query Parameters ### Header Parameters ### Returns ### Example #### Response
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: List Deployments
3url: https://platform.claude.com/docs/en/api/beta/deployments/list
4---
1# List Deployments
52
6## List Deployments
3**GET** `/v1/deployments`
74
8**get** `/v1/deployments`
9
105List Deployments
116
12### Query Parameters
7## Query parameters
138
149- `agent_id: optional string`
1510
from line 14
1914
2015 Return deployments created at or after this time (inclusive).
2116
17 format: date-time
18
2219- `"created_at[lte]": optional string`
2320
2421 Return deployments created at or before this time (inclusive).
2522
23 format: date-time
24
2625- `include_archived: optional boolean`
2726
2827 When true, includes archived deployments. Default: false (exclude archived).
from line 30
3130
3231 Maximum results per page. Default 20, maximum 100.
3332
33 format: int32
34
3435- `page: optional string`
3536
3637 Opaque pagination cursor.
from line 44
4344
4445 - `"paused"`
4546
46### Header Parameters
47## Headers
4748
4849- `"anthropic-beta": optional array of AnthropicBeta`
4950
from line 122
121122
122123 - `"mid-conversation-tool-changes-2026-07-01"`
123124
124### Returns
125## Returns
125126
126127- `data: array of BetaManagedAgentsDeployment`
127128
from line 140
139140
140141 - `type: "agent"`
141142
142 - `"agent"`
143
144143 - `version: number`
145144
145 format: int32
146
146147 - `archived_at: string or null`
147148
148149 A timestamp in RFC 3339 format
149150
151 format: date-time
152
150153 - `created_at: string`
151154
152155 A timestamp in RFC 3339 format
153156
157 format: date-time
158
154159 - `description: string or null`
155160
156161 Description of what the deployment does.
from line 168
163168
164169 Events sent to each session immediately after creation.
165170
166 - `BetaManagedAgentsDeploymentUserMessageEvent object { content, type }`
171 - `BetaManagedAgentsDeploymentUserMessageEvent object`
167172
168173 A user message sent to the session.
169174
from line 176
171176
172177 Array of content blocks for the user message.
173178
174 - `BetaManagedAgentsTextBlock object { text, type }`
179 - `BetaManagedAgentsTextBlock object`
175180
176181 Regular text content.
177182
from line 184
179184
180185 The text content.
181186
187 minLength: 1
188
182189 - `type: "text"`
183190
184 - `"text"`
191 - `BetaManagedAgentsImageBlock object`
185192
186 - `BetaManagedAgentsImageBlock object { source, type }`
187
188193 Image content specified directly as base64 data or as a reference via a URL.
189194
190195 - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`
from line 196
191196
192197 Union type for image source variants.
193198
194 - `BetaManagedAgentsBase64ImageSource object { data, media_type, type }`
199 - `BetaManagedAgentsBase64ImageSource object`
195200
196201 Base64-encoded image data.
197202
from line 204
199204
200205 Base64-encoded image data.
201206
207 minLength: 1
208
202209 - `media_type: string`
203210
204211 MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").
205212
213 minLength: 1
214
206215 - `type: "base64"`
207216
208 - `"base64"`
217 - `BetaManagedAgentsURLImageSource object`
209218
210 - `BetaManagedAgentsURLImageSource object { type, url }`
211
212219 Image referenced by URL.
213220
214221 - `type: "url"`
215222
216 - `"url"`
217
218223 - `url: string`
219224
220225 URL of the image to fetch.
221226
222 - `BetaManagedAgentsFileImageSource object { file_id, type }`
227 minLength: 1
223228
229 - `BetaManagedAgentsFileImageSource object`
230
224231 Image referenced by file ID.
225232
226233 - `file_id: string`
from line 234
227234
228235 ID of a previously uploaded file.
229236
237 minLength: 1
238
230239 - `type: "file"`
231240
232 - `"file"`
233
234241 - `type: "image"`
235242
236 - `"image"`
243 - `BetaManagedAgentsDocumentBlock object`
237244
238 - `BetaManagedAgentsDocumentBlock object { source, type, context, title }`
239
240245 Document content, either specified directly as base64 data, as text, or as a reference via a URL.
241246
242247 - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`
from line 248
243248
244249 Union type for document source variants.
245250
246 - `BetaManagedAgentsBase64DocumentSource object { data, media_type, type }`
251 - `BetaManagedAgentsBase64DocumentSource object`
247252
248253 Base64-encoded document data.
249254
from line 256
251256
252257 Base64-encoded document data.
253258
259 minLength: 1
260
254261 - `media_type: string`
255262
256263 MIME type of the document (e.g., "application/pdf").
257264
265 minLength: 1
266
258267 - `type: "base64"`
259268
260 - `"base64"`
269 - `BetaManagedAgentsPlainTextDocumentSource object`
261270
262 - `BetaManagedAgentsPlainTextDocumentSource object { data, media_type, type }`
263
264271 Plain text document content.
265272
266273 - `data: string`
from line 274
267274
268275 The plain text content.
269276
277 minLength: 1
278
270279 - `media_type: "text/plain"`
271280
272281 MIME type of the text content. Must be "text/plain".
273282
274 - `"text/plain"`
275
276283 - `type: "text"`
277284
278 - `"text"`
285 - `BetaManagedAgentsURLDocumentSource object`
279286
280 - `BetaManagedAgentsURLDocumentSource object { type, url }`
281
282287 Document referenced by URL.
283288
284289 - `type: "url"`
285290
286 - `"url"`
287
288291 - `url: string`
289292
290293 URL of the document to fetch.
291294
292 - `BetaManagedAgentsFileDocumentSource object { file_id, type }`
295 minLength: 1
293296
297 - `BetaManagedAgentsFileDocumentSource object`
298
294299 Document referenced by file ID.
295300
296301 - `file_id: string`
from line 302
297302
298303 ID of a previously uploaded file.
299304
305 minLength: 1
306
300307 - `type: "file"`
301308
302 - `"file"`
303
304309 - `type: "document"`
305310
306 - `"document"`
307
308311 - `context: optional string or null`
309312
310313 Additional context about the document for the model.
from line 316
313316
314317 The title of the document.
315318
316 - `BetaManagedAgentsRedactedBlock object { type }`
319 - `BetaManagedAgentsRedactedBlock object`
317320
318321 Placeholder for content withheld by Anthropic model policy.
319322
320323 - `type: "redacted"`
321324
322 - `"redacted"`
323
324325 - `type: "user.message"`
325326
326 - `"user.message"`
327 - `BetaManagedAgentsDeploymentUserDefineOutcomeEvent object`
327328
328 - `BetaManagedAgentsDeploymentUserDefineOutcomeEvent object { description, rubric, type, max_iterations }`
329
330329 An outcome the agent should work toward. The agent begins work on receipt.
331330
332331 - `description: string`
from line 336
337336
338337 Rubric for grading the quality of an outcome.
339338
340 - `BetaManagedAgentsFileRubric object { file_id, type }`
339 - `BetaManagedAgentsFileRubric object`
341340
342341 Rubric referenced by a file uploaded via the Files API.
343342
from line 346
347346
348347 - `type: "file"`
349348
350 - `"file"`
349 - `BetaManagedAgentsTextRubric object`
351350
352 - `BetaManagedAgentsTextRubric object { content, type }`
353
354351 Rubric content provided inline as text.
355352
356353 - `content: string`
from line 356
359356
360357 - `type: "text"`
361358
362 - `"text"`
363
364359 - `type: "user.define_outcome"`
365360
366 - `"user.define_outcome"`
367
368361 - `max_iterations: optional number or null`
369362
370363 Eval→revision cycles before giving up. Default 3, max 20.
371364
372 - `BetaManagedAgentsDeploymentSystemMessageEvent object { content, type }`
365 format: int32
373366
367 - `BetaManagedAgentsDeploymentSystemMessageEvent object`
368
374369 Privileged context for the accompanying turn and all subsequent turns, appended to the session's system context as a `role: "system"` turn rather than replacing the top-level system prompt.
375370
376371 - `content: array of BetaManagedAgentsSystemContentBlock`
from line 376
381376
382377 The text content.
383378
379 minLength: 1
380
384381 - `type: "text"`
385382
386 - `"text"`
387
388383 - `type: "system.message"`
389384
390 - `"system.message"`
391
392385 - `metadata: map[string]`
393386
394387 Arbitrary key-value metadata. Maximum 16 pairs.
from line 394
401394
402395 Why a deployment is paused. Non-null exactly when `status` is `paused`.
403396
404 - `BetaManagedAgentsManualDeploymentPausedReason object { type }`
397 - `BetaManagedAgentsManualDeploymentPausedReason object`
405398
406399 The caller invoked the pause endpoint on the deployment.
407400
408401 - `type: "manual"`
409402
410 - `"manual"`
403 - `BetaManagedAgentsErrorDeploymentPausedReason object`
411404
412 - `BetaManagedAgentsErrorDeploymentPausedReason object { error, type }`
413
414405 A scheduled fire recorded a failed run whose error auto-pauses the deployment.
415406
416407 - `error: BetaManagedAgentsDeploymentPausedReasonError`
from line 408
417408
418409 The error that triggered an auto-pause. Matches the failed run's `error.type`.
419410
420 - `BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError object { type }`
411 - `BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError object`
421412
422413 The deployment's environment was archived.
423414
424415 - `type: "environment_archived_error"`
425416
426 - `"environment_archived_error"`
417 - `BetaManagedAgentsAgentArchivedDeploymentPausedReasonError object`
427418
428 - `BetaManagedAgentsAgentArchivedDeploymentPausedReasonError object { type }`
429
430419 The deployment's agent was archived.
431420
432421 - `type: "agent_archived_error"`
433422
434 - `"agent_archived_error"`
423 - `BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError object`
435424
436 - `BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError object { type }`
437
438425 The deployment's environment no longer exists.
439426
440427 - `type: "environment_not_found_error"`
441428
442 - `"environment_not_found_error"`
429 - `BetaManagedAgentsVaultNotFoundDeploymentPausedReasonError object`
443430
444 - `BetaManagedAgentsVaultNotFoundDeploymentPausedReasonError object { type }`
445
446431 A vault referenced by the deployment no longer exists.
447432
448433 - `type: "vault_not_found_error"`
449434
450 - `"vault_not_found_error"`
435 - `BetaManagedAgentsFileNotFoundDeploymentPausedReasonError object`
451436
452 - `BetaManagedAgentsFileNotFoundDeploymentPausedReasonError object { type }`
453
454437 A file resource referenced by the deployment no longer exists.
455438
456439 - `type: "file_not_found_error"`
457440
458 - `"file_not_found_error"`
441 - `BetaManagedAgentsSessionResourceNotFoundDeploymentPausedReasonError object`
459442
460 - `BetaManagedAgentsSessionResourceNotFoundDeploymentPausedReasonError object { type }`
461
462443 A referenced resource no longer exists and its kind was not reported.
463444
464445 - `type: "session_resource_not_found_error"`
465446
466 - `"session_resource_not_found_error"`
447 - `BetaManagedAgentsWorkspaceArchivedDeploymentPausedReasonError object`
467448
468 - `BetaManagedAgentsWorkspaceArchivedDeploymentPausedReasonError object { type }`
469
470449 The deployment's workspace was archived.
471450
472451 - `type: "workspace_archived_error"`
473452
474 - `"workspace_archived_error"`
453 - `BetaManagedAgentsOrganizationDisabledDeploymentPausedReasonError object`
475454
476 - `BetaManagedAgentsOrganizationDisabledDeploymentPausedReasonError object { type }`
477
478455 The deployment's organization is disabled.
479456
480457 - `type: "organization_disabled_error"`
481458
482 - `"organization_disabled_error"`
459 - `BetaManagedAgentsMemoryStoreArchivedDeploymentPausedReasonError object`
483460
484 - `BetaManagedAgentsMemoryStoreArchivedDeploymentPausedReasonError object { type }`
485
486461 A memory store referenced by the deployment is archived.
487462
488463 - `type: "memory_store_archived_error"`
489464
490 - `"memory_store_archived_error"`
465 - `BetaManagedAgentsSkillNotFoundDeploymentPausedReasonError object`
491466
492 - `BetaManagedAgentsSkillNotFoundDeploymentPausedReasonError object { type }`
493
494467 A skill referenced by the deployment's agent no longer exists.
495468
496469 - `type: "skill_not_found_error"`
497470
498 - `"skill_not_found_error"`
471 - `BetaManagedAgentsVaultArchivedDeploymentPausedReasonError object`
499472
500 - `BetaManagedAgentsVaultArchivedDeploymentPausedReasonError object { type }`
501
502473 A vault referenced by the deployment is archived.
503474
504475 - `type: "vault_archived_error"`
505476
506 - `"vault_archived_error"`
477 - `BetaManagedAgentsUnknownDeploymentPausedReasonError object`
507478
508 - `BetaManagedAgentsUnknownDeploymentPausedReasonError object { type }`
509
510479 An unrecognized error auto-paused the deployment. A fallback variant; matches a run whose `error.type` is `unknown_error`.
511480
512481 - `type: "unknown_error"`
513482
514 - `"unknown_error"`
483 - `BetaManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonError object`
515484
516 - `BetaManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonError object { type }`
517
518485 The deployment configures resources, but its environment is self-hosted and cannot mount them.
519486
520487 - `type: "self_hosted_resources_unsupported_error"`
521488
522 - `"self_hosted_resources_unsupported_error"`
489 - `BetaManagedAgentsMCPEgressBlockedDeploymentPausedReasonError object`
523490
524 - `BetaManagedAgentsMCPEgressBlockedDeploymentPausedReasonError object { type }`
525
526491 An MCP server host used by the deployment's agent is blocked by the environment's network policy.
527492
528493 - `type: "mcp_egress_blocked_error"`
529494
530 - `"mcp_egress_blocked_error"`
531
532495 - `type: "error"`
533496
534 - `"error"`
535
536497 - `resources: array of BetaManagedAgentsSessionResourceConfig`
537498
538499 Resources attached to sessions created from this deployment. Echoes the input minus write-only credentials.
539500
540 - `BetaManagedAgentsGitHubRepositoryResourceConfig object { type, url, checkout, mount_path }`
501 - `BetaManagedAgentsGitHubRepositoryResourceConfig object`
541502
542503 A GitHub repository mounted into each session's container. The authorization token is write-only and never returned.
543504
544505 - `type: "github_repository"`
545506
546 - `"github_repository"`
547
548507 - `url: string`
549508
550509 Github URL of the repository
from line 512
553512
554513 Branch or commit to check out. Defaults to the repository's default branch.
555514
556 - `BetaManagedAgentsBranchCheckout object { name, type }`
515 - `BetaManagedAgentsBranchCheckout object`
557516
558517 - `name: string`
559518
560519 Branch name to check out.
561520
521 minLength: 1, maxLength: 255
522
562523 - `type: "branch"`
563524
564 - `"branch"`
525 - `BetaManagedAgentsCommitCheckout object`
565526
566 - `BetaManagedAgentsCommitCheckout object { sha, type }`
567
568527 - `sha: string`
569528
570529 Full commit SHA to check out.
571530
531 minLength: 7, maxLength: 64
532
572533 - `type: "commit"`
573534
574 - `"commit"`
575
576535 - `mount_path: optional string or null`
577536
578537 Mount path in the container. Defaults to `/workspace/<repo-name>`.
579538
580 - `BetaManagedAgentsFileResourceConfig object { file_id, type, mount_path }`
539 - `BetaManagedAgentsFileResourceConfig object`
581540
582541 A file mounted into each session's container.
583542
from line 546
587546
588547 - `type: "file"`
589548
590 - `"file"`
591
592549 - `mount_path: optional string or null`
593550
594551 Mount path in the container. Defaults to `/mnt/session/uploads/<file_id>`.
595552
596 - `BetaManagedAgentsMemoryStoreResourceConfig object { memory_store_id, type, access, instructions }`
553 - `BetaManagedAgentsMemoryStoreResourceConfig object`
597554
598555 A memory store attached to each session created from this deployment.
599556
from line 560
603560
604561 - `type: "memory_store"`
605562
606 - `"memory_store"`
607
608563 - `access: optional "read_write" or "read_only" or null`
609564
610565 Access mode for an attached memory store.
from line 580
625580
626581 5-field POSIX cron expression: minute hour day-of-month month day-of-week (e.g., "0 9 * * 1-5" for weekdays at 9am). Day-of-week is 0-7 where 0 and 7 both mean Sunday. Extended cron syntax - seconds or year fields, and the special characters L, W, #, and ? - is not supported, nor are predefined shortcuts (@daily).
627582
583 minLength: 1, maxLength: 256
584
628585 - `timezone: string`
629586
630587 IANA timezone identifier (e.g., "America/Los_Angeles", "UTC").
631588
589 minLength: 1
590
632591 - `type: "cron"`
633592
634 - `"cron"`
635
636593 - `last_run_at: optional string or null`
637594
638595 A timestamp in RFC 3339 format
639596
597 format: date-time
598
640599 - `upcoming_runs_at: optional array of string`
641600
642601 Up to 5 timestamps of upcoming cron occurrences. Non-empty for active and paused deployments (reflects what the schedule would do if unpaused); empty once the deployment is archived (`archived_at` set). Each fire is offset by a small per-schedule jitter, so a run will actually start at or shortly after its listed time.
from line 610
651610
652611 - `type: "deployment"`
653612
654 - `"deployment"`
655
656613 - `updated_at: string`
657614
658615 A timestamp in RFC 3339 format
659616
617 format: date-time
618
660619 - `vault_ids: array of string`
661620
662621 Vault IDs supplying stored credentials for sessions created from this deployment.
from line 636
677636
678637 Uppercase ISO-4217 currency code. `USD` is the only currency currently supported; the accepted set is closed and grows only when a new currency is priced.
679638
680 - `"USD"`
681
682639 - `type: "limit"`
683640
684 - `"limit"`
685
686641- `next_page: optional string or null`
687642
688643 Opaque cursor for the next page. Null when no more results.
689644
690### Example
645## Example
691646
692```http
647```bash
693648curl https://api.anthropic.com/v1/deployments \
694649 -H 'anthropic-version: 2023-06-01' \
695650 -H 'anthropic-beta: managed-agents-2026-04-01' \
from line 651
696651 -H "X-Api-Key: $ANTHROPIC_API_KEY"
697652```
698653
699#### Response
654### Response (200)
700655
701656```json
702657{
No line in this hunk matches that.