Deployment Runs changedapi/beta/deployment_runs
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+119added
Lines−252removed
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
### Query parameters ### Headers #### Response (200) ### Path parameters ### Headers #### Response (200) ## Domain types ### Query Parameters ### Header Parameters #### Response ### Path Parameters ### Header Parameters #### Response ## Domain Types
The whole hunk
from line 1, old and new numbered
/
from line 1
1---
2title: Deployment Runs
3url: https://platform.claude.com/docs/en/api/beta/deployment_runs
4---
5
61# Deployment Runs
72
83## List Deployment Runs
94
10**get** `/v1/deployment_runs`
5**GET** `/v1/deployment_runs`
116
127List Deployment Runs
138
14### Query Parameters
9### Query parameters
1510
1611- `"created_at[gt]": optional string`
1712
1813 Return runs created strictly after this time (exclusive).
1914
15 format: date-time
16
2017- `"created_at[gte]": optional string`
2118
2219 Return runs created at or after this time (inclusive).
2320
21 format: date-time
22
2423- `"created_at[lt]": optional string`
2524
2625 Return runs created strictly before this time (exclusive).
2726
27 format: date-time
28
2829- `"created_at[lte]": optional string`
2930
3031 Return runs created at or before this time (inclusive).
3132
33 format: date-time
34
3235- `deployment_id: optional string`
3336
3437 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 44
4144
4245 Maximum results per page. Default 20, maximum 1000.
4346
47 format: int32
48
4449- `page: optional string`
4550
4651 Opaque pagination cursor. Pass next_page from the previous response. Invalid or expired cursors return 400.
from line 58
5358
5459 - `"manual"`
5560
56### Header Parameters
61### Headers
5762
5863- `"anthropic-beta": optional array of AnthropicBeta`
5964
from line 154
149154
150155 - `type: "agent"`
151156
152 - `"agent"`
153
154157 - `version: number`
155158
159 format: int32
160
156161 - `created_at: string`
157162
158163 A timestamp in RFC 3339 format
159164
165 format: date-time
166
160167 - `deployment_id: string`
161168
162169 ID of the deployment that produced this run.
from line 172
165172
166173 Why the run failed to create a session. The type identifies the failure; message is human-readable detail.
167174
168 - `BetaManagedAgentsEnvironmentArchivedRunError object { message, type }`
175 - `BetaManagedAgentsEnvironmentArchivedRunError object`
169176
170177 The deployment's environment was archived.
171178
from line 182
175182
176183 - `type: "environment_archived_error"`
177184
178 - `"environment_archived_error"`
185 - `BetaManagedAgentsAgentArchivedRunError object`
179186
180 - `BetaManagedAgentsAgentArchivedRunError object { message, type }`
181
182187 The deployment's agent was archived.
183188
184189 - `message: string`
from line 192
187192
188193 - `type: "agent_archived_error"`
189194
190 - `"agent_archived_error"`
195 - `BetaManagedAgentsEnvironmentNotFoundRunError object`
191196
192 - `BetaManagedAgentsEnvironmentNotFoundRunError object { message, type }`
193
194197 The deployment's environment no longer exists.
195198
196199 - `message: string`
from line 202
199202
200203 - `type: "environment_not_found_error"`
201204
202 - `"environment_not_found_error"`
205 - `BetaManagedAgentsVaultNotFoundRunError object`
203206
204 - `BetaManagedAgentsVaultNotFoundRunError object { message, type }`
205
206207 A vault referenced by the deployment no longer exists.
207208
208209 - `message: string`
from line 212
211212
212213 - `type: "vault_not_found_error"`
213214
214 - `"vault_not_found_error"`
215 - `BetaManagedAgentsVaultArchivedRunError object`
215216
216 - `BetaManagedAgentsVaultArchivedRunError object { message, type }`
217
218217 A vault referenced by the deployment is archived.
219218
220219 - `message: string`
from line 222
223222
224223 - `type: "vault_archived_error"`
225224
226 - `"vault_archived_error"`
225 - `BetaManagedAgentsFileNotFoundRunError object`
227226
228 - `BetaManagedAgentsFileNotFoundRunError object { message, type }`
229
230227 A file resource referenced by the deployment no longer exists.
231228
232229 - `message: string`
from line 232
235232
236233 - `type: "file_not_found_error"`
237234
238 - `"file_not_found_error"`
235 - `BetaManagedAgentsMemoryStoreArchivedRunError object`
239236
240 - `BetaManagedAgentsMemoryStoreArchivedRunError object { message, type }`
241
242237 A memory store referenced by the deployment is archived.
243238
244239 - `message: string`
from line 242
247242
248243 - `type: "memory_store_archived_error"`
249244
250 - `"memory_store_archived_error"`
245 - `BetaManagedAgentsSkillNotFoundRunError object`
251246
252 - `BetaManagedAgentsSkillNotFoundRunError object { message, type }`
253
254247 A skill referenced by the deployment's agent no longer exists.
255248
256249 - `message: string`
from line 252
259252
260253 - `type: "skill_not_found_error"`
261254
262 - `"skill_not_found_error"`
255 - `BetaManagedAgentsSessionResourceNotFoundRunError object`
263256
264 - `BetaManagedAgentsSessionResourceNotFoundRunError object { message, type }`
265
266257 A referenced resource no longer exists and its kind was not reported.
267258
268259 - `message: string`
from line 262
271262
272263 - `type: "session_resource_not_found_error"`
273264
274 - `"session_resource_not_found_error"`
265 - `BetaManagedAgentsWorkspaceArchivedRunError object`
275266
276 - `BetaManagedAgentsWorkspaceArchivedRunError object { message, type }`
277
278267 The deployment's workspace was archived.
279268
280269 - `message: string`
from line 272
283272
284273 - `type: "workspace_archived_error"`
285274
286 - `"workspace_archived_error"`
275 - `BetaManagedAgentsOrganizationDisabledRunError object`
287276
288 - `BetaManagedAgentsOrganizationDisabledRunError object { message, type }`
289
290277 The deployment's organization is disabled.
291278
292279 - `message: string`
from line 282
295282
296283 - `type: "organization_disabled_error"`
297284
298 - `"organization_disabled_error"`
285 - `BetaManagedAgentsSessionRateLimitedRunError object`
299286
300 - `BetaManagedAgentsSessionRateLimitedRunError object { message, type }`
301
302287 Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.
303288
304289 - `message: string`
from line 292
307292
308293 - `type: "session_rate_limited_error"`
309294
310 - `"session_rate_limited_error"`
295 - `BetaManagedAgentsSessionCreationRejectedRunError object`
311296
312 - `BetaManagedAgentsSessionCreationRejectedRunError object { message, type }`
313
314297 The session create request was rejected with a non-retryable validation error.
315298
316299 - `message: string`
from line 302
319302
320303 - `type: "session_creation_rejected_error"`
321304
322 - `"session_creation_rejected_error"`
305 - `BetaManagedAgentsUnknownRunError object`
323306
324 - `BetaManagedAgentsUnknownRunError object { message, type }`
325
326307 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.
327308
328309 - `message: string`
from line 312
331312
332313 - `type: "unknown_error"`
333314
334 - `"unknown_error"`
315 - `BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object`
335316
336 - `BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object { message, type }`
337
338317 The deployment configures resources, but its environment is self-hosted and cannot mount them.
339318
340319 - `message: string`
from line 322
343322
344323 - `type: "self_hosted_resources_unsupported_error"`
345324
346 - `"self_hosted_resources_unsupported_error"`
325 - `BetaManagedAgentsMCPEgressBlockedRunError object`
347326
348 - `BetaManagedAgentsMCPEgressBlockedRunError object { message, type }`
349
350327 An MCP server host used by the deployment's agent is blocked by the environment's network policy.
351328
352329 - `message: string`
from line 332
355332
356333 - `type: "mcp_egress_blocked_error"`
357334
358 - `"mcp_egress_blocked_error"`
359
360335 - `session_id: string or null`
361336
362337 Populated on success. Null on creation failure. Exactly one of session_id or error is non-null.
from line 340
365340
366341 Describes what triggered a deployment run, with trigger-specific metadata.
367342
368 - `BetaManagedAgentsScheduleTriggerContext object { scheduled_at, type }`
343 - `BetaManagedAgentsScheduleTriggerContext object`
369344
370345 The run was fired by the deployment's cron schedule.
371346
from line 348
373348
374349 A timestamp in RFC 3339 format
375350
351 format: date-time
352
376353 - `type: "schedule"`
377354
378 - `"schedule"`
355 - `BetaManagedAgentsManualTriggerContext object`
379356
380 - `BetaManagedAgentsManualTriggerContext object { type }`
381
382357 The run was started manually by creating a session directly against the deployment.
383358
384359 - `type: "manual"`
385360
386 - `"manual"`
387
388361 - `type: "deployment_run"`
389362
390 - `"deployment_run"`
391
392363- `next_page: optional string or null`
393364
394365 Opaque cursor for the next page. Null when no more results.
from line 366
395366
396367### Example
397368
398```http
369```bash
399370curl https://api.anthropic.com/v1/deployment_runs \
400371 -H 'anthropic-version: 2023-06-01' \
401372 -H 'anthropic-beta: managed-agents-2026-04-01' \
from line 373
402373 -H "X-Api-Key: $ANTHROPIC_API_KEY"
403374```
404375
405#### Response
376#### Response (200)
406377
407378```json
408379{
from line 405
434405
435406## Get Deployment Run
436407
437**get** `/v1/deployment_runs/{deployment_run_id}`
408**GET** `/v1/deployment_runs/{deployment_run_id}`
438409
439410Get Deployment Run
440411
441### Path Parameters
412### Path parameters
442413
443414- `deployment_run_id: string`
444415
445### Header Parameters
416### Headers
446417
447418- `"anthropic-beta": optional array of AnthropicBeta`
448419
from line 493
522493
523494### Returns
524495
525- `BetaManagedAgentsDeploymentRun object { id, agent, created_at, 5 more }`
496- `BetaManagedAgentsDeploymentRun object`
526497
527498 A persistent, append-only record of a single deployment execution. Records session creation success or failure — no session lifecycle tracking.
528499
from line 509
538509
539510 - `type: "agent"`
540511
541 - `"agent"`
542
543512 - `version: number`
544513
514 format: int32
515
545516 - `created_at: string`
546517
547518 A timestamp in RFC 3339 format
548519
520 format: date-time
521
549522 - `deployment_id: string`
550523
551524 ID of the deployment that produced this run.
from line 527
554527
555528 Why the run failed to create a session. The type identifies the failure; message is human-readable detail.
556529
557 - `BetaManagedAgentsEnvironmentArchivedRunError object { message, type }`
530 - `BetaManagedAgentsEnvironmentArchivedRunError object`
558531
559532 The deployment's environment was archived.
560533
from line 537
564537
565538 - `type: "environment_archived_error"`
566539
567 - `"environment_archived_error"`
540 - `BetaManagedAgentsAgentArchivedRunError object`
568541
569 - `BetaManagedAgentsAgentArchivedRunError object { message, type }`
570
571542 The deployment's agent was archived.
572543
573544 - `message: string`
from line 547
576547
577548 - `type: "agent_archived_error"`
578549
579 - `"agent_archived_error"`
550 - `BetaManagedAgentsEnvironmentNotFoundRunError object`
580551
581 - `BetaManagedAgentsEnvironmentNotFoundRunError object { message, type }`
582
583552 The deployment's environment no longer exists.
584553
585554 - `message: string`
from line 557
588557
589558 - `type: "environment_not_found_error"`
590559
591 - `"environment_not_found_error"`
560 - `BetaManagedAgentsVaultNotFoundRunError object`
592561
593 - `BetaManagedAgentsVaultNotFoundRunError object { message, type }`
594
595562 A vault referenced by the deployment no longer exists.
596563
597564 - `message: string`
from line 567
600567
601568 - `type: "vault_not_found_error"`
602569
603 - `"vault_not_found_error"`
570 - `BetaManagedAgentsVaultArchivedRunError object`
604571
605 - `BetaManagedAgentsVaultArchivedRunError object { message, type }`
606
607572 A vault referenced by the deployment is archived.
608573
609574 - `message: string`
from line 577
612577
613578 - `type: "vault_archived_error"`
614579
615 - `"vault_archived_error"`
580 - `BetaManagedAgentsFileNotFoundRunError object`
616581
617 - `BetaManagedAgentsFileNotFoundRunError object { message, type }`
618
619582 A file resource referenced by the deployment no longer exists.
620583
621584 - `message: string`
from line 587
624587
625588 - `type: "file_not_found_error"`
626589
627 - `"file_not_found_error"`
590 - `BetaManagedAgentsMemoryStoreArchivedRunError object`
628591
629 - `BetaManagedAgentsMemoryStoreArchivedRunError object { message, type }`
630
631592 A memory store referenced by the deployment is archived.
632593
633594 - `message: string`
from line 597
636597
637598 - `type: "memory_store_archived_error"`
638599
639 - `"memory_store_archived_error"`
600 - `BetaManagedAgentsSkillNotFoundRunError object`
640601
641 - `BetaManagedAgentsSkillNotFoundRunError object { message, type }`
642
643602 A skill referenced by the deployment's agent no longer exists.
644603
645604 - `message: string`
from line 607
648607
649608 - `type: "skill_not_found_error"`
650609
651 - `"skill_not_found_error"`
610 - `BetaManagedAgentsSessionResourceNotFoundRunError object`
652611
653 - `BetaManagedAgentsSessionResourceNotFoundRunError object { message, type }`
654
655612 A referenced resource no longer exists and its kind was not reported.
656613
657614 - `message: string`
from line 617
660617
661618 - `type: "session_resource_not_found_error"`
662619
663 - `"session_resource_not_found_error"`
620 - `BetaManagedAgentsWorkspaceArchivedRunError object`
664621
665 - `BetaManagedAgentsWorkspaceArchivedRunError object { message, type }`
666
667622 The deployment's workspace was archived.
668623
669624 - `message: string`
from line 627
672627
673628 - `type: "workspace_archived_error"`
674629
675 - `"workspace_archived_error"`
630 - `BetaManagedAgentsOrganizationDisabledRunError object`
676631
677 - `BetaManagedAgentsOrganizationDisabledRunError object { message, type }`
678
679632 The deployment's organization is disabled.
680633
681634 - `message: string`
from line 637
684637
685638 - `type: "organization_disabled_error"`
686639
687 - `"organization_disabled_error"`
640 - `BetaManagedAgentsSessionRateLimitedRunError object`
688641
689 - `BetaManagedAgentsSessionRateLimitedRunError object { message, type }`
690
691642 Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.
692643
693644 - `message: string`
from line 647
696647
697648 - `type: "session_rate_limited_error"`
698649
699 - `"session_rate_limited_error"`
650 - `BetaManagedAgentsSessionCreationRejectedRunError object`
700651
701 - `BetaManagedAgentsSessionCreationRejectedRunError object { message, type }`
702
703652 The session create request was rejected with a non-retryable validation error.
704653
705654 - `message: string`
from line 657
708657
709658 - `type: "session_creation_rejected_error"`
710659
711 - `"session_creation_rejected_error"`
660 - `BetaManagedAgentsUnknownRunError object`
712661
713 - `BetaManagedAgentsUnknownRunError object { message, type }`
714
715662 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.
716663
717664 - `message: string`
from line 667
720667
721668 - `type: "unknown_error"`
722669
723 - `"unknown_error"`
670 - `BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object`
724671
725 - `BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object { message, type }`
726
727672 The deployment configures resources, but its environment is self-hosted and cannot mount them.
728673
729674 - `message: string`
from line 677
732677
733678 - `type: "self_hosted_resources_unsupported_error"`
734679
735 - `"self_hosted_resources_unsupported_error"`
680 - `BetaManagedAgentsMCPEgressBlockedRunError object`
736681
737 - `BetaManagedAgentsMCPEgressBlockedRunError object { message, type }`
738
739682 An MCP server host used by the deployment's agent is blocked by the environment's network policy.
740683
741684 - `message: string`
from line 687
744687
745688 - `type: "mcp_egress_blocked_error"`
746689
747 - `"mcp_egress_blocked_error"`
748
749690 - `session_id: string or null`
750691
751692 Populated on success. Null on creation failure. Exactly one of session_id or error is non-null.
from line 695
754695
755696 Describes what triggered a deployment run, with trigger-specific metadata.
756697
757 - `BetaManagedAgentsScheduleTriggerContext object { scheduled_at, type }`
698 - `BetaManagedAgentsScheduleTriggerContext object`
758699
759700 The run was fired by the deployment's cron schedule.
760701
from line 703
762703
763704 A timestamp in RFC 3339 format
764705
706 format: date-time
707
765708 - `type: "schedule"`
766709
767 - `"schedule"`
710 - `BetaManagedAgentsManualTriggerContext object`
768711
769 - `BetaManagedAgentsManualTriggerContext object { type }`
770
771712 The run was started manually by creating a session directly against the deployment.
772713
773714 - `type: "manual"`
774715
775 - `"manual"`
776
777716 - `type: "deployment_run"`
778717
779 - `"deployment_run"`
780
781718### Example
782719
783```http
720```bash
784721curl https://api.anthropic.com/v1/deployment_runs/$DEPLOYMENT_RUN_ID \
785722 -H 'anthropic-version: 2023-06-01' \
786723 -H 'anthropic-beta: managed-agents-2026-04-01' \
from line 724
787724 -H "X-Api-Key: $ANTHROPIC_API_KEY"
788725```
789726
790#### Response
727#### Response (200)
791728
792729```json
793730{
from line 749
812749}
813750```
814751
815## Domain Types
752## Domain types
816753
817754### Beta Managed Agents Agent Archived Run Error
818755
819- `BetaManagedAgentsAgentArchivedRunError object { message, type }`
756- `BetaManagedAgentsAgentArchivedRunError object`
820757
821758 The deployment's agent was archived.
822759
from line 763
826763
827764 - `type: "agent_archived_error"`
828765
829 - `"agent_archived_error"`
830
831766### Beta Managed Agents Deployment Run
832767
833- `BetaManagedAgentsDeploymentRun object { id, agent, created_at, 5 more }`
768- `BetaManagedAgentsDeploymentRun object`
834769
835770 A persistent, append-only record of a single deployment execution. Records session creation success or failure — no session lifecycle tracking.
836771
from line 781
846781
847782 - `type: "agent"`
848783
849 - `"agent"`
850
851784 - `version: number`
852785
786 format: int32
787
853788 - `created_at: string`
854789
855790 A timestamp in RFC 3339 format
856791
792 format: date-time
793
857794 - `deployment_id: string`
858795
859796 ID of the deployment that produced this run.
from line 799
862799
863800 Why the run failed to create a session. The type identifies the failure; message is human-readable detail.
864801
865 - `BetaManagedAgentsEnvironmentArchivedRunError object { message, type }`
802 - `BetaManagedAgentsEnvironmentArchivedRunError object`
866803
867804 The deployment's environment was archived.
868805
from line 809
872809
873810 - `type: "environment_archived_error"`
874811
875 - `"environment_archived_error"`
812 - `BetaManagedAgentsAgentArchivedRunError object`
876813
877 - `BetaManagedAgentsAgentArchivedRunError object { message, type }`
878
879814 The deployment's agent was archived.
880815
881816 - `message: string`
from line 819
884819
885820 - `type: "agent_archived_error"`
886821
887 - `"agent_archived_error"`
822 - `BetaManagedAgentsEnvironmentNotFoundRunError object`
888823
889 - `BetaManagedAgentsEnvironmentNotFoundRunError object { message, type }`
890
891824 The deployment's environment no longer exists.
892825
893826 - `message: string`
from line 829
896829
897830 - `type: "environment_not_found_error"`
898831
899 - `"environment_not_found_error"`
832 - `BetaManagedAgentsVaultNotFoundRunError object`
900833
901 - `BetaManagedAgentsVaultNotFoundRunError object { message, type }`
902
903834 A vault referenced by the deployment no longer exists.
904835
905836 - `message: string`
from line 839
908839
909840 - `type: "vault_not_found_error"`
910841
911 - `"vault_not_found_error"`
842 - `BetaManagedAgentsVaultArchivedRunError object`
912843
913 - `BetaManagedAgentsVaultArchivedRunError object { message, type }`
914
915844 A vault referenced by the deployment is archived.
916845
917846 - `message: string`
from line 849
920849
921850 - `type: "vault_archived_error"`
922851
923 - `"vault_archived_error"`
852 - `BetaManagedAgentsFileNotFoundRunError object`
924853
925 - `BetaManagedAgentsFileNotFoundRunError object { message, type }`
926
927854 A file resource referenced by the deployment no longer exists.
928855
929856 - `message: string`
from line 859
932859
933860 - `type: "file_not_found_error"`
934861
935 - `"file_not_found_error"`
862 - `BetaManagedAgentsMemoryStoreArchivedRunError object`
936863
937 - `BetaManagedAgentsMemoryStoreArchivedRunError object { message, type }`
938
939864 A memory store referenced by the deployment is archived.
940865
941866 - `message: string`
from line 869
944869
945870 - `type: "memory_store_archived_error"`
946871
947 - `"memory_store_archived_error"`
872 - `BetaManagedAgentsSkillNotFoundRunError object`
948873
949 - `BetaManagedAgentsSkillNotFoundRunError object { message, type }`
950
951874 A skill referenced by the deployment's agent no longer exists.
952875
953876 - `message: string`
from line 879
956879
957880 - `type: "skill_not_found_error"`
958881
959 - `"skill_not_found_error"`
882 - `BetaManagedAgentsSessionResourceNotFoundRunError object`
960883
961 - `BetaManagedAgentsSessionResourceNotFoundRunError object { message, type }`
962
963884 A referenced resource no longer exists and its kind was not reported.
964885
965886 - `message: string`
from line 889
968889
969890 - `type: "session_resource_not_found_error"`
970891
971 - `"session_resource_not_found_error"`
892 - `BetaManagedAgentsWorkspaceArchivedRunError object`
972893
973 - `BetaManagedAgentsWorkspaceArchivedRunError object { message, type }`
974
975894 The deployment's workspace was archived.
976895
977896 - `message: string`
from line 899
980899
981900 - `type: "workspace_archived_error"`
982901
983 - `"workspace_archived_error"`
902 - `BetaManagedAgentsOrganizationDisabledRunError object`
984903
985 - `BetaManagedAgentsOrganizationDisabledRunError object { message, type }`
986
987904 The deployment's organization is disabled.
988905
989906 - `message: string`
from line 909
992909
993910 - `type: "organization_disabled_error"`
994911
995 - `"organization_disabled_error"`
912 - `BetaManagedAgentsSessionRateLimitedRunError object`
996913
997 - `BetaManagedAgentsSessionRateLimitedRunError object { message, type }`
998
999914 Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.
1000915
1001916 - `message: string`
from line 919
1004919
1005920 - `type: "session_rate_limited_error"`
1006921
1007 - `"session_rate_limited_error"`
922 - `BetaManagedAgentsSessionCreationRejectedRunError object`
1008923
1009 - `BetaManagedAgentsSessionCreationRejectedRunError object { message, type }`
1010
1011924 The session create request was rejected with a non-retryable validation error.
1012925
1013926 - `message: string`
from line 929
1016929
1017930 - `type: "session_creation_rejected_error"`
1018931
1019 - `"session_creation_rejected_error"`
932 - `BetaManagedAgentsUnknownRunError object`
1020933
1021 - `BetaManagedAgentsUnknownRunError object { message, type }`
1022
1023934 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.
1024935
1025936 - `message: string`
from line 939
1028939
1029940 - `type: "unknown_error"`
1030941
1031 - `"unknown_error"`
942 - `BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object`
1032943
1033 - `BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object { message, type }`
1034
1035944 The deployment configures resources, but its environment is self-hosted and cannot mount them.
1036945
1037946 - `message: string`
from line 949
1040949
1041950 - `type: "self_hosted_resources_unsupported_error"`
1042951
1043 - `"self_hosted_resources_unsupported_error"`
952 - `BetaManagedAgentsMCPEgressBlockedRunError object`
1044953
1045 - `BetaManagedAgentsMCPEgressBlockedRunError object { message, type }`
1046
1047954 An MCP server host used by the deployment's agent is blocked by the environment's network policy.
1048955
1049956 - `message: string`
from line 959
1052959
1053960 - `type: "mcp_egress_blocked_error"`
1054961
1055 - `"mcp_egress_blocked_error"`
1056
1057962 - `session_id: string or null`
1058963
1059964 Populated on success. Null on creation failure. Exactly one of session_id or error is non-null.
from line 967
1062967
1063968 Describes what triggered a deployment run, with trigger-specific metadata.
1064969
1065 - `BetaManagedAgentsScheduleTriggerContext object { scheduled_at, type }`
970 - `BetaManagedAgentsScheduleTriggerContext object`
1066971
1067972 The run was fired by the deployment's cron schedule.
1068973
from line 975
1070975
1071976 A timestamp in RFC 3339 format
1072977
978 format: date-time
979
1073980 - `type: "schedule"`
1074981
1075 - `"schedule"`
982 - `BetaManagedAgentsManualTriggerContext object`
1076983
1077 - `BetaManagedAgentsManualTriggerContext object { type }`
1078
1079984 The run was started manually by creating a session directly against the deployment.
1080985
1081986 - `type: "manual"`
1082987
1083 - `"manual"`
1084
1085988 - `type: "deployment_run"`
1086989
1087 - `"deployment_run"`
1088
1089990### Beta Managed Agents Environment Archived Run Error
1090991
1091- `BetaManagedAgentsEnvironmentArchivedRunError object { message, type }`
992- `BetaManagedAgentsEnvironmentArchivedRunError object`
1092993
1093994 The deployment's environment was archived.
1094995
from line 999
1098999
10991000 - `type: "environment_archived_error"`
11001001
1101 - `"environment_archived_error"`
1102
11031002### Beta Managed Agents Environment Not Found Run Error
11041003
1105- `BetaManagedAgentsEnvironmentNotFoundRunError object { message, type }`
1004- `BetaManagedAgentsEnvironmentNotFoundRunError object`
11061005
11071006 The deployment's environment no longer exists.
11081007
from line 1011
11121011
11131012 - `type: "environment_not_found_error"`
11141013
1115 - `"environment_not_found_error"`
1116
11171014### Beta Managed Agents File Not Found Run Error
11181015
1119- `BetaManagedAgentsFileNotFoundRunError object { message, type }`
1016- `BetaManagedAgentsFileNotFoundRunError object`
11201017
11211018 A file resource referenced by the deployment no longer exists.
11221019
from line 1023
11261023
11271024 - `type: "file_not_found_error"`
11281025
1129 - `"file_not_found_error"`
1130
11311026### Beta Managed Agents Manual Trigger Context
11321027
1133- `BetaManagedAgentsManualTriggerContext object { type }`
1028- `BetaManagedAgentsManualTriggerContext object`
11341029
11351030 The run was started manually by creating a session directly against the deployment.
11361031
11371032 - `type: "manual"`
11381033
1139 - `"manual"`
1140
11411034### Beta Managed Agents MCP Egress Blocked Run Error
11421035
1143- `BetaManagedAgentsMCPEgressBlockedRunError object { message, type }`
1036- `BetaManagedAgentsMCPEgressBlockedRunError object`
11441037
11451038 An MCP server host used by the deployment's agent is blocked by the environment's network policy.
11461039
from line 1043
11501043
11511044 - `type: "mcp_egress_blocked_error"`
11521045
1153 - `"mcp_egress_blocked_error"`
1154
11551046### Beta Managed Agents Memory Store Archived Run Error
11561047
1157- `BetaManagedAgentsMemoryStoreArchivedRunError object { message, type }`
1048- `BetaManagedAgentsMemoryStoreArchivedRunError object`
11581049
11591050 A memory store referenced by the deployment is archived.
11601051
from line 1055
11641055
11651056 - `type: "memory_store_archived_error"`
11661057
1167 - `"memory_store_archived_error"`
1168
11691058### Beta Managed Agents Organization Disabled Run Error
11701059
1171- `BetaManagedAgentsOrganizationDisabledRunError object { message, type }`
1060- `BetaManagedAgentsOrganizationDisabledRunError object`
11721061
11731062 The deployment's organization is disabled.
11741063
from line 1067
11781067
11791068 - `type: "organization_disabled_error"`
11801069
1181 - `"organization_disabled_error"`
1182
11831070### Beta Managed Agents Schedule Trigger Context
11841071
1185- `BetaManagedAgentsScheduleTriggerContext object { scheduled_at, type }`
1072- `BetaManagedAgentsScheduleTriggerContext object`
11861073
11871074 The run was fired by the deployment's cron schedule.
11881075
from line 1077
11901077
11911078 A timestamp in RFC 3339 format
11921079
1080 format: date-time
1081
11931082 - `type: "schedule"`
11941083
1195 - `"schedule"`
1196
11971084### Beta Managed Agents Self Hosted Resources Unsupported Run Error
11981085
1199- `BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object { message, type }`
1086- `BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object`
12001087
12011088 The deployment configures resources, but its environment is self-hosted and cannot mount them.
12021089
from line 1093
12061093
12071094 - `type: "self_hosted_resources_unsupported_error"`
12081095
1209 - `"self_hosted_resources_unsupported_error"`
1210
12111096### Beta Managed Agents Session Creation Rejected Run Error
12121097
1213- `BetaManagedAgentsSessionCreationRejectedRunError object { message, type }`
1098- `BetaManagedAgentsSessionCreationRejectedRunError object`
12141099
12151100 The session create request was rejected with a non-retryable validation error.
12161101
from line 1105
12201105
12211106 - `type: "session_creation_rejected_error"`
12221107
1223 - `"session_creation_rejected_error"`
1224
12251108### Beta Managed Agents Session Rate Limited Run Error
12261109
1227- `BetaManagedAgentsSessionRateLimitedRunError object { message, type }`
1110- `BetaManagedAgentsSessionRateLimitedRunError object`
12281111
12291112 Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.
12301113
from line 1117
12341117
12351118 - `type: "session_rate_limited_error"`
12361119
1237 - `"session_rate_limited_error"`
1238
12391120### Beta Managed Agents Session Resource Not Found Run Error
12401121
1241- `BetaManagedAgentsSessionResourceNotFoundRunError object { message, type }`
1122- `BetaManagedAgentsSessionResourceNotFoundRunError object`
12421123
12431124 A referenced resource no longer exists and its kind was not reported.
12441125
from line 1129
12481129
12491130 - `type: "session_resource_not_found_error"`
12501131
1251 - `"session_resource_not_found_error"`
1252
12531132### Beta Managed Agents Skill Not Found Run Error
12541133
1255- `BetaManagedAgentsSkillNotFoundRunError object { message, type }`
1134- `BetaManagedAgentsSkillNotFoundRunError object`
12561135
12571136 A skill referenced by the deployment's agent no longer exists.
12581137
from line 1141
12621141
12631142 - `type: "skill_not_found_error"`
12641143
1265 - `"skill_not_found_error"`
1266
12671144### Beta Managed Agents Trigger Context
12681145
12691146- `BetaManagedAgentsTriggerContext = BetaManagedAgentsScheduleTriggerContext or BetaManagedAgentsManualTriggerContext`
from line 1147
12701147
12711148 Describes what triggered a deployment run, with trigger-specific metadata.
12721149
1273 - `BetaManagedAgentsScheduleTriggerContext object { scheduled_at, type }`
1150 - `BetaManagedAgentsScheduleTriggerContext object`
12741151
12751152 The run was fired by the deployment's cron schedule.
12761153
from line 1155
12781155
12791156 A timestamp in RFC 3339 format
12801157
1158 format: date-time
1159
12811160 - `type: "schedule"`
12821161
1283 - `"schedule"`
1162 - `BetaManagedAgentsManualTriggerContext object`
12841163
1285 - `BetaManagedAgentsManualTriggerContext object { type }`
1286
12871164 The run was started manually by creating a session directly against the deployment.
12881165
12891166 - `type: "manual"`
12901167
1291 - `"manual"`
1292
12931168### Beta Managed Agents Trigger Type
12941169
12951170- `BetaManagedAgentsTriggerType = "schedule" or "manual"`
from line 1177
13021177
13031178### Beta Managed Agents Unknown Run Error
13041179
1305- `BetaManagedAgentsUnknownRunError object { message, type }`
1180- `BetaManagedAgentsUnknownRunError object`
13061181
13071182 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.
13081183
from line 1187
13121187
13131188 - `type: "unknown_error"`
13141189
1315 - `"unknown_error"`
1316
13171190### Beta Managed Agents Vault Archived Run Error
13181191
1319- `BetaManagedAgentsVaultArchivedRunError object { message, type }`
1192- `BetaManagedAgentsVaultArchivedRunError object`
13201193
13211194 A vault referenced by the deployment is archived.
13221195
from line 1199
13261199
13271200 - `type: "vault_archived_error"`
13281201
1329 - `"vault_archived_error"`
1330
13311202### Beta Managed Agents Vault Not Found Run Error
13321203
1333- `BetaManagedAgentsVaultNotFoundRunError object { message, type }`
1204- `BetaManagedAgentsVaultNotFoundRunError object`
13341205
13351206 A vault referenced by the deployment no longer exists.
13361207
from line 1211
13401211
13411212 - `type: "vault_not_found_error"`
13421213
1343 - `"vault_not_found_error"`
1344
13451214### Beta Managed Agents Workspace Archived Run Error
13461215
1347- `BetaManagedAgentsWorkspaceArchivedRunError object { message, type }`
1216- `BetaManagedAgentsWorkspaceArchivedRunError object`
13481217
13491218 The deployment's workspace was archived.
13501219
from line 1222
13531222 Human-readable error description.
13541223
13551224 - `type: "workspace_archived_error"`
1356
1357 - `"workspace_archived_error"`
13581225
No line in this hunk matches that.