Create Deployment changedapi/beta/deployments/create
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+169added
Lines−218removed
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
# Create Deployment ## Headers ## Body parameters ## Returns ## Example ### Response (200) ## Create Deployment ### Header Parameters ### Body Parameters ### Returns ### Example #### Response
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: Create Deployment
3url: https://platform.claude.com/docs/en/api/beta/deployments/create
4---
1# Create Deployment
52
6## Create Deployment
3**POST** `/v1/deployments`
74
8**post** `/v1/deployments`
9
105Create Deployment
116
12### Header Parameters
7## Headers
138
149- `"anthropic-beta": optional array of AnthropicBeta`
1510
from line 82
8782
8883 - `"mid-conversation-tool-changes-2026-07-01"`
8984
90### Body Parameters
85## Body parameters
9186
9287- `agent: string or BetaManagedAgentsAgentParams`
9388
from line 90
9590
9691 - `string`
9792
98 - `BetaManagedAgentsAgentParams object { id, type, version }`
93 - `BetaManagedAgentsAgentParams object`
9994
10095 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version
10196
from line 98
10398
10499 The `agent` ID.
105100
101 minLength: 1, maxLength: 128
102
106103 - `type: "agent"`
107104
108 - `"agent"`
109
110105 - `version: optional number`
111106
112107 The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified.
113108
109 format: int32
110
114111- `environment_id: string`
115112
116113 ID of the `environment` defining the container configuration for sessions created from this deployment.
117114
115 minLength: 1, maxLength: 128
116
118117- `initial_events: array of BetaManagedAgentsDeploymentInitialEventParams`
119118
120119 Events to send to each session immediately after creation. At least 1, maximum 50.
121120
122 - `BetaManagedAgentsUserMessageEventParams object { content, type }`
121 - `BetaManagedAgentsUserMessageEventParams object`
123122
124123 Parameters for sending a user message to the session.
125124
from line 126
127126
128127 Array of content blocks for the user message.
129128
130 - `BetaManagedAgentsTextBlock object { text, type }`
129 - `BetaManagedAgentsTextBlock object`
131130
132131 Regular text content.
133132
from line 134
135134
136135 The text content.
137136
137 minLength: 1
138
138139 - `type: "text"`
139140
140 - `"text"`
141 - `BetaManagedAgentsImageBlock object`
141142
142 - `BetaManagedAgentsImageBlock object { source, type }`
143
144143 Image content specified directly as base64 data or as a reference via a URL.
145144
146145 - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`
from line 146
147146
148147 Union type for image source variants.
149148
150 - `BetaManagedAgentsBase64ImageSource object { data, media_type, type }`
149 - `BetaManagedAgentsBase64ImageSource object`
151150
152151 Base64-encoded image data.
153152
from line 154
155154
156155 Base64-encoded image data.
157156
157 minLength: 1
158
158159 - `media_type: string`
159160
160161 MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").
161162
163 minLength: 1
164
162165 - `type: "base64"`
163166
164 - `"base64"`
167 - `BetaManagedAgentsURLImageSource object`
165168
166 - `BetaManagedAgentsURLImageSource object { type, url }`
167
168169 Image referenced by URL.
169170
170171 - `type: "url"`
171172
172 - `"url"`
173
174173 - `url: string`
175174
176175 URL of the image to fetch.
177176
178 - `BetaManagedAgentsFileImageSource object { file_id, type }`
177 minLength: 1
179178
179 - `BetaManagedAgentsFileImageSource object`
180
180181 Image referenced by file ID.
181182
182183 - `file_id: string`
from line 184
183184
184185 ID of a previously uploaded file.
185186
187 minLength: 1
188
186189 - `type: "file"`
187190
188 - `"file"`
189
190191 - `type: "image"`
191192
192 - `"image"`
193 - `BetaManagedAgentsDocumentBlock object`
193194
194 - `BetaManagedAgentsDocumentBlock object { source, type, context, title }`
195
196195 Document content, either specified directly as base64 data, as text, or as a reference via a URL.
197196
198197 - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`
from line 198
199198
200199 Union type for document source variants.
201200
202 - `BetaManagedAgentsBase64DocumentSource object { data, media_type, type }`
201 - `BetaManagedAgentsBase64DocumentSource object`
203202
204203 Base64-encoded document data.
205204
from line 206
207206
208207 Base64-encoded document data.
209208
209 minLength: 1
210
210211 - `media_type: string`
211212
212213 MIME type of the document (e.g., "application/pdf").
213214
215 minLength: 1
216
214217 - `type: "base64"`
215218
216 - `"base64"`
219 - `BetaManagedAgentsPlainTextDocumentSource object`
217220
218 - `BetaManagedAgentsPlainTextDocumentSource object { data, media_type, type }`
219
220221 Plain text document content.
221222
222223 - `data: string`
from line 224
223224
224225 The plain text content.
225226
227 minLength: 1
228
226229 - `media_type: "text/plain"`
227230
228231 MIME type of the text content. Must be "text/plain".
229232
230 - `"text/plain"`
231
232233 - `type: "text"`
233234
234 - `"text"`
235 - `BetaManagedAgentsURLDocumentSource object`
235236
236 - `BetaManagedAgentsURLDocumentSource object { type, url }`
237
238237 Document referenced by URL.
239238
240239 - `type: "url"`
241240
242 - `"url"`
243
244241 - `url: string`
245242
246243 URL of the document to fetch.
247244
248 - `BetaManagedAgentsFileDocumentSource object { file_id, type }`
245 minLength: 1
249246
247 - `BetaManagedAgentsFileDocumentSource object`
248
250249 Document referenced by file ID.
251250
252251 - `file_id: string`
from line 252
253252
254253 ID of a previously uploaded file.
255254
255 minLength: 1
256
256257 - `type: "file"`
257258
258 - `"file"`
259
260259 - `type: "document"`
261260
262 - `"document"`
263
264261 - `context: optional string or null`
265262
266263 Additional context about the document for the model.
from line 266
269266
270267 The title of the document.
271268
272 - `BetaManagedAgentsRedactedBlock object { type }`
269 - `BetaManagedAgentsRedactedBlock object`
273270
274271 Placeholder for content withheld by Anthropic model policy.
275272
276273 - `type: "redacted"`
277274
278 - `"redacted"`
279
280275 - `type: "user.message"`
281276
282 - `"user.message"`
277 - `BetaManagedAgentsUserDefineOutcomeEventParams object`
283278
284 - `BetaManagedAgentsUserDefineOutcomeEventParams object { description, rubric, type, max_iterations }`
285
286279 Parameters for defining an outcome the agent should work toward. The agent begins work on receipt.
287280
288281 - `description: string`
from line 286
293286
294287 Rubric for grading the quality of an outcome.
295288
296 - `BetaManagedAgentsFileRubricParams object { file_id, type }`
289 - `BetaManagedAgentsFileRubricParams object`
297290
298291 Rubric referenced by a file uploaded via the Files API.
299292
from line 296
303296
304297 - `type: "file"`
305298
306 - `"file"`
299 - `BetaManagedAgentsTextRubricParams object`
307300
308 - `BetaManagedAgentsTextRubricParams object { content, type }`
309
310301 Rubric content provided inline as text.
311302
312303 - `content: string`
from line 304
313304
314305 Rubric content. Plain text or markdown — the grader treats it as freeform text. Maximum 262144 characters.
315306
307 maxLength: 262144
308
316309 - `type: "text"`
317310
318 - `"text"`
319
320311 - `type: "user.define_outcome"`
321312
322 - `"user.define_outcome"`
323
324313 - `max_iterations: optional number or null`
325314
326315 Eval→revision cycles before giving up. Default 3, max 20.
327316
328 - `BetaManagedAgentsSystemMessageEventParams object { content, type }`
317 format: int32
329318
319 - `BetaManagedAgentsSystemMessageEventParams object`
320
330321 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. At most one per request: it must be the final event and immediately follow the `user.message`, `user.tool_result`, or `user.custom_tool_result` it accompanies. Only supported on models that accept mid-conversation system messages.
331322
332323 - `content: array of BetaManagedAgentsSystemContentBlock`
from line 328
337328
338329 The text content.
339330
331 minLength: 1
332
340333 - `type: "text"`
341334
342 - `"text"`
343
344335 - `type: "system.message"`
345336
346 - `"system.message"`
347
348337- `name: string`
349338
350339 Human-readable name for the deployment.
351340
341 minLength: 1, maxLength: 256
342
352343- `budget: optional BetaManagedAgentsBudgetLimit or null`
353344
354345 A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.
from line 356
365356
366357 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.
367358
368 - `"USD"`
369
370359 - `type: "limit"`
371360
372 - `"limit"`
373
374361- `description: optional string or null`
375362
376363 Description of what the deployment does.
377364
365 maxLength: 2048
366
378367- `metadata: optional map[string]`
379368
380369 Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.
from line 372
383372
384373 Resources (e.g. repositories, files) to mount into each session's container. Maximum 500.
385374
386 - `BetaManagedAgentsGitHubRepositoryResourceParams object { authorization_token, type, url, 2 more }`
375 - `BetaManagedAgentsGitHubRepositoryResourceParams object`
387376
388377 Mount a GitHub repository into the session's container.
389378
from line 380
391380
392381 GitHub authorization token used to clone the repository.
393382
383 minLength: 1, maxLength: 4096
384
394385 - `type: "github_repository"`
395386
396 - `"github_repository"`
397
398387 - `url: string`
399388
400389 Github URL of the repository
401390
391 minLength: 1, maxLength: 2048
392
402393 - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`
403394
404395 Branch or commit to check out. Defaults to the repository's default branch.
405396
406 - `BetaManagedAgentsBranchCheckout object { name, type }`
397 - `BetaManagedAgentsBranchCheckout object`
407398
408399 - `name: string`
409400
410401 Branch name to check out.
411402
403 minLength: 1, maxLength: 255
404
412405 - `type: "branch"`
413406
414 - `"branch"`
407 - `BetaManagedAgentsCommitCheckout object`
415408
416 - `BetaManagedAgentsCommitCheckout object { sha, type }`
417
418409 - `sha: string`
419410
420411 Full commit SHA to check out.
421412
413 minLength: 7, maxLength: 64
414
422415 - `type: "commit"`
423416
424 - `"commit"`
425
426417 - `mount_path: optional string or null`
427418
428419 Mount path in the container. Defaults to `/workspace/<repo-name>`.
429420
430 - `BetaManagedAgentsFileResourceParams object { file_id, type, mount_path }`
421 minLength: 1, maxLength: 4096
431422
423 - `BetaManagedAgentsFileResourceParams object`
424
432425 Mount a file uploaded via the Files API into the session.
433426
434427 - `file_id: string`
from line 428
435428
436429 ID of a previously uploaded file.
437430
431 minLength: 1, maxLength: 128
432
438433 - `type: "file"`
439434
440 - `"file"`
441
442435 - `mount_path: optional string or null`
443436
444437 Mount path in the container. Defaults to `/mnt/session/uploads/<file_id>`.
445438
446 - `BetaManagedAgentsMemoryStoreResourceParam object { memory_store_id, type, access, instructions }`
439 minLength: 1, maxLength: 4096
447440
441 - `BetaManagedAgentsMemoryStoreResourceParam object`
442
448443 Parameters for attaching a memory store to an agent session.
449444
450445 - `memory_store_id: string`
from line 448
453448
454449 - `type: "memory_store"`
455450
456 - `"memory_store"`
457
458451 - `access: optional "read_write" or "read_only" or null`
459452
460453 Access mode for an attached memory store.
from line 460
467460
468461 Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.
469462
463 maxLength: 4096
464
470465- `schedule: optional BetaManagedAgentsScheduleParams or null`
471466
472467 5-field POSIX cron schedule. Literal wall-clock matching in the configured timezone.
from line 470
475470
476471 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).
477472
473 minLength: 1, maxLength: 256
474
478475 - `timezone: string`
479476
480477 Required. IANA timezone identifier (e.g., "America/Los_Angeles", "UTC"). Validated against the IANA timezone database.
481478
479 minLength: 1
480
482481 - `type: "cron"`
483482
484 - `"cron"`
485
486483- `vault_ids: optional array of string`
487484
488485 Vault IDs for stored credentials the agent can use during sessions created from this deployment. Maximum 50.
489486
490### Returns
487## Returns
491488
492- `BetaManagedAgentsDeployment object { id, agent, archived_at, 14 more }`
489- `BetaManagedAgentsDeployment object`
493490
494491 A deployment is a configured instance of an agent — it binds the agent to everything needed to run it autonomously: an environment, credentials, initial events, and an optional schedule.
495492
from line 502
505502
506503 - `type: "agent"`
507504
508 - `"agent"`
509
510505 - `version: number`
511506
507 format: int32
508
512509 - `archived_at: string or null`
513510
514511 A timestamp in RFC 3339 format
515512
513 format: date-time
514
516515 - `created_at: string`
517516
518517 A timestamp in RFC 3339 format
519518
519 format: date-time
520
520521 - `description: string or null`
521522
522523 Description of what the deployment does.
from line 530
529530
530531 Events sent to each session immediately after creation.
531532
532 - `BetaManagedAgentsDeploymentUserMessageEvent object { content, type }`
533 - `BetaManagedAgentsDeploymentUserMessageEvent object`
533534
534535 A user message sent to the session.
535536
from line 538
537538
538539 Array of content blocks for the user message.
539540
540 - `BetaManagedAgentsTextBlock object { text, type }`
541 - `BetaManagedAgentsTextBlock object`
541542
542543 Regular text content.
543544
from line 546
545546
546547 The text content.
547548
549 minLength: 1
550
548551 - `type: "text"`
549552
550 - `"text"`
553 - `BetaManagedAgentsImageBlock object`
551554
552 - `BetaManagedAgentsImageBlock object { source, type }`
553
554555 Image content specified directly as base64 data or as a reference via a URL.
555556
556557 - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`
from line 558
557558
558559 Union type for image source variants.
559560
560 - `BetaManagedAgentsBase64ImageSource object { data, media_type, type }`
561 - `BetaManagedAgentsBase64ImageSource object`
561562
562563 Base64-encoded image data.
563564
from line 566
565566
566567 Base64-encoded image data.
567568
569 minLength: 1
570
568571 - `media_type: string`
569572
570573 MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").
571574
575 minLength: 1
576
572577 - `type: "base64"`
573578
574 - `"base64"`
579 - `BetaManagedAgentsURLImageSource object`
575580
576 - `BetaManagedAgentsURLImageSource object { type, url }`
577
578581 Image referenced by URL.
579582
580583 - `type: "url"`
581584
582 - `"url"`
583
584585 - `url: string`
585586
586587 URL of the image to fetch.
587588
588 - `BetaManagedAgentsFileImageSource object { file_id, type }`
589 minLength: 1
589590
591 - `BetaManagedAgentsFileImageSource object`
592
590593 Image referenced by file ID.
591594
592595 - `file_id: string`
from line 596
593596
594597 ID of a previously uploaded file.
595598
599 minLength: 1
600
596601 - `type: "file"`
597602
598 - `"file"`
599
600603 - `type: "image"`
601604
602 - `"image"`
605 - `BetaManagedAgentsDocumentBlock object`
603606
604 - `BetaManagedAgentsDocumentBlock object { source, type, context, title }`
605
606607 Document content, either specified directly as base64 data, as text, or as a reference via a URL.
607608
608609 - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`
from line 610
609610
610611 Union type for document source variants.
611612
612 - `BetaManagedAgentsBase64DocumentSource object { data, media_type, type }`
613 - `BetaManagedAgentsBase64DocumentSource object`
613614
614615 Base64-encoded document data.
615616
from line 618
617618
618619 Base64-encoded document data.
619620
621 minLength: 1
622
620623 - `media_type: string`
621624
622625 MIME type of the document (e.g., "application/pdf").
623626
627 minLength: 1
628
624629 - `type: "base64"`
625630
626 - `"base64"`
631 - `BetaManagedAgentsPlainTextDocumentSource object`
627632
628 - `BetaManagedAgentsPlainTextDocumentSource object { data, media_type, type }`
629
630633 Plain text document content.
631634
632635 - `data: string`
from line 636
633636
634637 The plain text content.
635638
639 minLength: 1
640
636641 - `media_type: "text/plain"`
637642
638643 MIME type of the text content. Must be "text/plain".
639644
640 - `"text/plain"`
641
642645 - `type: "text"`
643646
644 - `"text"`
647 - `BetaManagedAgentsURLDocumentSource object`
645648
646 - `BetaManagedAgentsURLDocumentSource object { type, url }`
647
648649 Document referenced by URL.
649650
650651 - `type: "url"`
651652
652 - `"url"`
653
654653 - `url: string`
655654
656655 URL of the document to fetch.
657656
658 - `BetaManagedAgentsFileDocumentSource object { file_id, type }`
657 minLength: 1
659658
659 - `BetaManagedAgentsFileDocumentSource object`
660
660661 Document referenced by file ID.
661662
662663 - `file_id: string`
from line 664
663664
664665 ID of a previously uploaded file.
665666
667 minLength: 1
668
666669 - `type: "file"`
667670
668 - `"file"`
669
670671 - `type: "document"`
671672
672 - `"document"`
673
674673 - `context: optional string or null`
675674
676675 Additional context about the document for the model.
from line 678
679678
680679 The title of the document.
681680
682 - `BetaManagedAgentsRedactedBlock object { type }`
681 - `BetaManagedAgentsRedactedBlock object`
683682
684683 Placeholder for content withheld by Anthropic model policy.
685684
686685 - `type: "redacted"`
687686
688 - `"redacted"`
689
690687 - `type: "user.message"`
691688
692 - `"user.message"`
689 - `BetaManagedAgentsDeploymentUserDefineOutcomeEvent object`
693690
694 - `BetaManagedAgentsDeploymentUserDefineOutcomeEvent object { description, rubric, type, max_iterations }`
695
696691 An outcome the agent should work toward. The agent begins work on receipt.
697692
698693 - `description: string`
from line 698
703698
704699 Rubric for grading the quality of an outcome.
705700
706 - `BetaManagedAgentsFileRubric object { file_id, type }`
701 - `BetaManagedAgentsFileRubric object`
707702
708703 Rubric referenced by a file uploaded via the Files API.
709704
from line 708
713708
714709 - `type: "file"`
715710
716 - `"file"`
711 - `BetaManagedAgentsTextRubric object`
717712
718 - `BetaManagedAgentsTextRubric object { content, type }`
719
720713 Rubric content provided inline as text.
721714
722715 - `content: string`
from line 718
725718
726719 - `type: "text"`
727720
728 - `"text"`
729
730721 - `type: "user.define_outcome"`
731722
732 - `"user.define_outcome"`
733
734723 - `max_iterations: optional number or null`
735724
736725 Eval→revision cycles before giving up. Default 3, max 20.
737726
738 - `BetaManagedAgentsDeploymentSystemMessageEvent object { content, type }`
727 format: int32
739728
729 - `BetaManagedAgentsDeploymentSystemMessageEvent object`
730
740731 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.
741732
742733 - `content: array of BetaManagedAgentsSystemContentBlock`
from line 738
747738
748739 The text content.
749740
741 minLength: 1
742
750743 - `type: "text"`
751744
752 - `"text"`
753
754745 - `type: "system.message"`
755746
756 - `"system.message"`
757
758747 - `metadata: map[string]`
759748
760749 Arbitrary key-value metadata. Maximum 16 pairs.
from line 756
767756
768757 Why a deployment is paused. Non-null exactly when `status` is `paused`.
769758
770 - `BetaManagedAgentsManualDeploymentPausedReason object { type }`
759 - `BetaManagedAgentsManualDeploymentPausedReason object`
771760
772761 The caller invoked the pause endpoint on the deployment.
773762
774763 - `type: "manual"`
775764
776 - `"manual"`
765 - `BetaManagedAgentsErrorDeploymentPausedReason object`
777766
778 - `BetaManagedAgentsErrorDeploymentPausedReason object { error, type }`
779
780767 A scheduled fire recorded a failed run whose error auto-pauses the deployment.
781768
782769 - `error: BetaManagedAgentsDeploymentPausedReasonError`
from line 770
783770
784771 The error that triggered an auto-pause. Matches the failed run's `error.type`.
785772
786 - `BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError object { type }`
773 - `BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError object`
787774
788775 The deployment's environment was archived.
789776
790777 - `type: "environment_archived_error"`
791778
792 - `"environment_archived_error"`
779 - `BetaManagedAgentsAgentArchivedDeploymentPausedReasonError object`
793780
794 - `BetaManagedAgentsAgentArchivedDeploymentPausedReasonError object { type }`
795
796781 The deployment's agent was archived.
797782
798783 - `type: "agent_archived_error"`
799784
800 - `"agent_archived_error"`
785 - `BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError object`
801786
802 - `BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError object { type }`
803
804787 The deployment's environment no longer exists.
805788
806789 - `type: "environment_not_found_error"`
807790
808 - `"environment_not_found_error"`
791 - `BetaManagedAgentsVaultNotFoundDeploymentPausedReasonError object`
809792
810 - `BetaManagedAgentsVaultNotFoundDeploymentPausedReasonError object { type }`
811
812793 A vault referenced by the deployment no longer exists.
813794
814795 - `type: "vault_not_found_error"`
815796
816 - `"vault_not_found_error"`
797 - `BetaManagedAgentsFileNotFoundDeploymentPausedReasonError object`
817798
818 - `BetaManagedAgentsFileNotFoundDeploymentPausedReasonError object { type }`
819
820799 A file resource referenced by the deployment no longer exists.
821800
822801 - `type: "file_not_found_error"`
823802
824 - `"file_not_found_error"`
803 - `BetaManagedAgentsSessionResourceNotFoundDeploymentPausedReasonError object`
825804
826 - `BetaManagedAgentsSessionResourceNotFoundDeploymentPausedReasonError object { type }`
827
828805 A referenced resource no longer exists and its kind was not reported.
829806
830807 - `type: "session_resource_not_found_error"`
831808
832 - `"session_resource_not_found_error"`
809 - `BetaManagedAgentsWorkspaceArchivedDeploymentPausedReasonError object`
833810
834 - `BetaManagedAgentsWorkspaceArchivedDeploymentPausedReasonError object { type }`
835
836811 The deployment's workspace was archived.
837812
838813 - `type: "workspace_archived_error"`
839814
840 - `"workspace_archived_error"`
815 - `BetaManagedAgentsOrganizationDisabledDeploymentPausedReasonError object`
841816
842 - `BetaManagedAgentsOrganizationDisabledDeploymentPausedReasonError object { type }`
843
844817 The deployment's organization is disabled.
845818
846819 - `type: "organization_disabled_error"`
847820
848 - `"organization_disabled_error"`
821 - `BetaManagedAgentsMemoryStoreArchivedDeploymentPausedReasonError object`
849822
850 - `BetaManagedAgentsMemoryStoreArchivedDeploymentPausedReasonError object { type }`
851
852823 A memory store referenced by the deployment is archived.
853824
854825 - `type: "memory_store_archived_error"`
855826
856 - `"memory_store_archived_error"`
827 - `BetaManagedAgentsSkillNotFoundDeploymentPausedReasonError object`
857828
858 - `BetaManagedAgentsSkillNotFoundDeploymentPausedReasonError object { type }`
859
860829 A skill referenced by the deployment's agent no longer exists.
861830
862831 - `type: "skill_not_found_error"`
863832
864 - `"skill_not_found_error"`
833 - `BetaManagedAgentsVaultArchivedDeploymentPausedReasonError object`
865834
866 - `BetaManagedAgentsVaultArchivedDeploymentPausedReasonError object { type }`
867
868835 A vault referenced by the deployment is archived.
869836
870837 - `type: "vault_archived_error"`
871838
872 - `"vault_archived_error"`
839 - `BetaManagedAgentsUnknownDeploymentPausedReasonError object`
873840
874 - `BetaManagedAgentsUnknownDeploymentPausedReasonError object { type }`
875
876841 An unrecognized error auto-paused the deployment. A fallback variant; matches a run whose `error.type` is `unknown_error`.
877842
878843 - `type: "unknown_error"`
879844
880 - `"unknown_error"`
845 - `BetaManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonError object`
881846
882 - `BetaManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonError object { type }`
883
884847 The deployment configures resources, but its environment is self-hosted and cannot mount them.
885848
886849 - `type: "self_hosted_resources_unsupported_error"`
887850
888 - `"self_hosted_resources_unsupported_error"`
851 - `BetaManagedAgentsMCPEgressBlockedDeploymentPausedReasonError object`
889852
890 - `BetaManagedAgentsMCPEgressBlockedDeploymentPausedReasonError object { type }`
891
892853 An MCP server host used by the deployment's agent is blocked by the environment's network policy.
893854
894855 - `type: "mcp_egress_blocked_error"`
895856
896 - `"mcp_egress_blocked_error"`
897
898857 - `type: "error"`
899858
900 - `"error"`
901
902859 - `resources: array of BetaManagedAgentsSessionResourceConfig`
903860
904861 Resources attached to sessions created from this deployment. Echoes the input minus write-only credentials.
905862
906 - `BetaManagedAgentsGitHubRepositoryResourceConfig object { type, url, checkout, mount_path }`
863 - `BetaManagedAgentsGitHubRepositoryResourceConfig object`
907864
908865 A GitHub repository mounted into each session's container. The authorization token is write-only and never returned.
909866
910867 - `type: "github_repository"`
911868
912 - `"github_repository"`
913
914869 - `url: string`
915870
916871 Github URL of the repository
from line 874
919874
920875 Branch or commit to check out. Defaults to the repository's default branch.
921876
922 - `BetaManagedAgentsBranchCheckout object { name, type }`
877 - `BetaManagedAgentsBranchCheckout object`
923878
924879 - `name: string`
925880
926881 Branch name to check out.
927882
883 minLength: 1, maxLength: 255
884
928885 - `type: "branch"`
929886
930 - `"branch"`
887 - `BetaManagedAgentsCommitCheckout object`
931888
932 - `BetaManagedAgentsCommitCheckout object { sha, type }`
933
934889 - `sha: string`
935890
936891 Full commit SHA to check out.
937892
893 minLength: 7, maxLength: 64
894
938895 - `type: "commit"`
939896
940 - `"commit"`
941
942897 - `mount_path: optional string or null`
943898
944899 Mount path in the container. Defaults to `/workspace/<repo-name>`.
945900
946 - `BetaManagedAgentsFileResourceConfig object { file_id, type, mount_path }`
901 - `BetaManagedAgentsFileResourceConfig object`
947902
948903 A file mounted into each session's container.
949904
from line 908
953908
954909 - `type: "file"`
955910
956 - `"file"`
957
958911 - `mount_path: optional string or null`
959912
960913 Mount path in the container. Defaults to `/mnt/session/uploads/<file_id>`.
961914
962 - `BetaManagedAgentsMemoryStoreResourceConfig object { memory_store_id, type, access, instructions }`
915 - `BetaManagedAgentsMemoryStoreResourceConfig object`
963916
964917 A memory store attached to each session created from this deployment.
965918
from line 922
969922
970923 - `type: "memory_store"`
971924
972 - `"memory_store"`
973
974925 - `access: optional "read_write" or "read_only" or null`
975926
976927 Access mode for an attached memory store.
from line 942
991942
992943 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).
993944
945 minLength: 1, maxLength: 256
946
994947 - `timezone: string`
995948
996949 IANA timezone identifier (e.g., "America/Los_Angeles", "UTC").
997950
951 minLength: 1
952
998953 - `type: "cron"`
999954
1000 - `"cron"`
1001
1002955 - `last_run_at: optional string or null`
1003956
1004957 A timestamp in RFC 3339 format
1005958
959 format: date-time
960
1006961 - `upcoming_runs_at: optional array of string`
1007962
1008963 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 972
1017972
1018973 - `type: "deployment"`
1019974
1020 - `"deployment"`
1021
1022975 - `updated_at: string`
1023976
1024977 A timestamp in RFC 3339 format
1025978
979 format: date-time
980
1026981 - `vault_ids: array of string`
1027982
1028983 Vault IDs supplying stored credentials for sessions created from this deployment.
from line 998
1043998
1044999 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.
10451000
1046 - `"USD"`
1047
10481001 - `type: "limit"`
10491002
1050 - `"limit"`
1003## Example
10511004
1052### Example
1053
1054```http
1005```bash
10551006curl https://api.anthropic.com/v1/deployments \
10561007 -H 'Content-Type: application/json' \
10571008 -H 'anthropic-version: 2023-06-01' \
from line 1026
10751026 }'
10761027```
10771028
1078#### Response
1029### Response (200)
10791030
10801031```json
10811032{
No line in this hunk matches that.