Repository Public
1---2title: Deployment Runs3url: https://platform.claude.com/docs/en/api/beta/deployment_runs4---56# Deployment Runs78## List Deployment Runs910**GET** `/v1/deployment_runs`1112List Deployment Runs1314### Query parameters1516- `"created_at[gt]": optional string`1718 Return runs created strictly after this time (exclusive).1920 format: date-time2122- `"created_at[gte]": optional string`2324 Return runs created at or after this time (inclusive).2526 format: date-time2728- `"created_at[lt]": optional string`2930 Return runs created strictly before this time (exclusive).3132 format: date-time3334- `"created_at[lte]": optional string`3536 Return runs created at or before this time (inclusive).3738 format: date-time3940- `deployment_id: optional string`4142 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.4344- `has_error: optional boolean`4546 Filter: true for runs with non-null `error`, false for runs with non-null `session_id`. Omit for all.4748- `limit: optional number`4950 Maximum results per page. Default 20, maximum 1000.5152 format: int325354- `page: optional string`5556 Opaque pagination cursor. Pass `next_page` from the previous response. Invalid or expired cursors return 400.5758- `trigger_type: optional BetaManagedAgentsTriggerType`5960 Filter runs by what triggered them. Omit to return all runs.6162 - `"schedule"`6364 - `"manual"`6566### Headers6768- `"anthropic-beta": optional array of AnthropicBeta`6970 Optional header to specify the beta version(s) you want to use.7172 - `string`7374 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`7576 - `"message-batches-2024-09-24"`7778 - `"prompt-caching-2024-07-31"`7980 - `"computer-use-2024-10-22"`8182 - `"computer-use-2025-01-24"`8384 - `"pdfs-2024-09-25"`8586 - `"token-counting-2024-11-01"`8788 - `"token-efficient-tools-2025-02-19"`8990 - `"output-128k-2025-02-19"`9192 - `"files-api-2025-04-14"`9394 - `"mcp-client-2025-04-04"`9596 - `"mcp-client-2025-11-20"`9798 - `"dev-full-thinking-2025-05-14"`99100 - `"interleaved-thinking-2025-05-14"`101102 - `"code-execution-2025-05-22"`103104 - `"extended-cache-ttl-2025-04-11"`105106 - `"context-1m-2025-08-07"`107108 - `"context-management-2025-06-27"`109110 - `"model-context-window-exceeded-2025-08-26"`111112 - `"skills-2025-10-02"`113114 - `"fast-mode-2026-02-01"`115116 - `"output-300k-2026-03-24"`117118 - `"user-profiles-2026-03-24"`119120 - `"user-profiles-2026-08-18"`121122 - `"user-profiles-2026-09-04"`123124 - `"advisor-tool-2026-03-01"`125126 - `"managed-agents-2026-04-01"`127128 - `"cache-diagnosis-2026-04-07"`129130 - `"dreaming-2026-04-21"`131132 - `"thinking-token-count-2026-05-13"`133134 - `"server-side-fallback-2026-06-01"`135136 - `"server-side-fallback-2026-07-01"`137138 - `"fallback-credit-2026-06-01"`139140 - `"fallback-credit-2026-07-01"`141142 - `"agent-memory-2026-07-22"`143144 - `"mid-conversation-tool-changes-2026-07-01"`145146 - `"compact-2026-01-12"`147148 - `"computer-use-2025-11-24"`149150 - `"mcp-tunnels-2026-06-22"`151152 - `"structured-outputs-2025-11-13"`153154 - `"task-budgets-2026-03-13"`155156 - `"thinking-display-updates-2026-08-18"`157158 - `"ce-user-management-2026-07-13"`159160 - `"mid-conversation-output-config-2026-07-01"`161162 - `"thinking-binding-controls-2026-08-01"`163164 - `"mid-conversation-system-clear-at-2026-08-21"`165166 - `"compact-2026-09-04"`167168- `"anthropic-workspace-id": optional string`169170### Returns171172- `data: array of BetaManagedAgentsDeploymentRun`173174 List of deployment runs.175176 - `type: "deployment_run"`177178 - `id: string`179180 Unique identifier for this run (`drun_...`).181182 - `agent: BetaManagedAgentsAgentReference`183184 A resolved agent reference with a concrete version.185186 - `type: "agent"`187188 - `id: string`189190 - `version: number`191192 format: int32193194 - `created_at: string`195196 A timestamp in RFC 3339 format197198 format: date-time199200 - `deployment_id: string`201202 ID of the deployment that produced this run.203204 - `error: BetaManagedAgentsEnvironmentArchivedRunError or BetaManagedAgentsAgentArchivedRunError or BetaManagedAgentsEnvironmentNotFoundRunError or 13 more or null`205206 Why the run failed to create a session. The type identifies the failure; message is human-readable detail.207208 - `BetaManagedAgentsEnvironmentArchivedRunError object`209210 The deployment's environment was archived.211212 - `type: "environment_archived_error"`213214 - `message: string`215216 Human-readable error description.217218 - `BetaManagedAgentsAgentArchivedRunError object`219220 The deployment's agent was archived.221222 - `type: "agent_archived_error"`223224 - `message: string`225226 Human-readable error description.227228 - `BetaManagedAgentsEnvironmentNotFoundRunError object`229230 The deployment's environment no longer exists.231232 - `type: "environment_not_found_error"`233234 - `message: string`235236 Human-readable error description.237238 - `BetaManagedAgentsVaultNotFoundRunError object`239240 A vault referenced by the deployment no longer exists.241242 - `type: "vault_not_found_error"`243244 - `message: string`245246 Human-readable error description.247248 - `BetaManagedAgentsVaultArchivedRunError object`249250 A vault referenced by the deployment is archived.251252 - `type: "vault_archived_error"`253254 - `message: string`255256 Human-readable error description.257258 - `BetaManagedAgentsFileNotFoundRunError object`259260 A file resource referenced by the deployment no longer exists.261262 - `type: "file_not_found_error"`263264 - `message: string`265266 Human-readable error description.267268 - `BetaManagedAgentsMemoryStoreArchivedRunError object`269270 A memory store referenced by the deployment is archived.271272 - `type: "memory_store_archived_error"`273274 - `message: string`275276 Human-readable error description.277278 - `BetaManagedAgentsSkillNotFoundRunError object`279280 A skill referenced by the deployment's agent no longer exists.281282 - `type: "skill_not_found_error"`283284 - `message: string`285286 Human-readable error description.287288 - `BetaManagedAgentsSessionResourceNotFoundRunError object`289290 A referenced resource no longer exists and its kind was not reported.291292 - `type: "session_resource_not_found_error"`293294 - `message: string`295296 Human-readable error description.297298 - `BetaManagedAgentsWorkspaceArchivedRunError object`299300 The deployment's workspace was archived.301302 - `type: "workspace_archived_error"`303304 - `message: string`305306 Human-readable error description.307308 - `BetaManagedAgentsOrganizationDisabledRunError object`309310 The deployment's organization is disabled.311312 - `type: "organization_disabled_error"`313314 - `message: string`315316 Human-readable error description.317318 - `BetaManagedAgentsSessionRateLimitedRunError object`319320 Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.321322 - `type: "session_rate_limited_error"`323324 - `message: string`325326 Human-readable error description.327328 - `BetaManagedAgentsSessionCreationRejectedRunError object`329330 The session create request was rejected with a non-retryable validation error.331332 - `type: "session_creation_rejected_error"`333334 - `message: string`335336 Human-readable error description.337338 - `BetaManagedAgentsUnknownRunError object`339340 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.341342 - `type: "unknown_error"`343344 - `message: string`345346 Human-readable error description.347348 - `BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object`349350 The deployment configures resources, but its environment is self-hosted and cannot mount them.351352 - `type: "self_hosted_resources_unsupported_error"`353354 - `message: string`355356 Human-readable error description.357358 - `BetaManagedAgentsMCPEgressBlockedRunError object`359360 An MCP server host used by the deployment's agent is blocked by the environment's network policy.361362 - `type: "mcp_egress_blocked_error"`363364 - `message: string`365366 Human-readable error description.367368 - `session_id: string or null`369370 Populated on success. Null on creation failure. Exactly one of `session_id` or `error` is non-null.371372 - `trigger_context: BetaManagedAgentsTriggerContext`373374 Describes what triggered a deployment run, with trigger-specific metadata.375376 - `BetaManagedAgentsScheduleTriggerContext object`377378 The run was fired by the deployment's cron schedule.379380 - `type: "schedule"`381382 - `scheduled_at: string`383384 A timestamp in RFC 3339 format385386 format: date-time387388 - `BetaManagedAgentsManualTriggerContext object`389390 The run was started manually by creating a session directly against the deployment.391392 - `type: "manual"`393394- `next_page: optional string or null`395396 Opaque cursor for the next page. Null when no more results.397398### Example399400```bash401curl https://api.anthropic.com/v1/deployment_runs \402 -H 'anthropic-version: 2023-06-01' \403 -H 'anthropic-beta: managed-agents-2026-04-01' \404 -H "X-Api-Key: $ANTHROPIC_API_KEY"405```406407#### Response (200)408409```json410{411 "data": [412 {413 "id": "id",414 "agent": {415 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",416 "type": "agent",417 "version": 1418 },419 "created_at": "2019-12-27T18:11:19.117Z",420 "deployment_id": "deployment_id",421 "error": {422 "message": "message",423 "type": "environment_archived_error"424 },425 "session_id": "session_id",426 "trigger_context": {427 "scheduled_at": "2019-12-27T18:11:19.117Z",428 "type": "schedule"429 },430 "type": "deployment_run"431 }432 ],433 "next_page": "next_page"434}435```436437## Get Deployment Run438439**GET** `/v1/deployment_runs/{deployment_run_id}`440441Get Deployment Run442443### Path parameters444445- `deployment_run_id: string`446447### Headers448449- `"anthropic-beta": optional array of AnthropicBeta`450451 Optional header to specify the beta version(s) you want to use.452453 - `string`454455 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`456457 - `"message-batches-2024-09-24"`458459 - `"prompt-caching-2024-07-31"`460461 - `"computer-use-2024-10-22"`462463 - `"computer-use-2025-01-24"`464465 - `"pdfs-2024-09-25"`466467 - `"token-counting-2024-11-01"`468469 - `"token-efficient-tools-2025-02-19"`470471 - `"output-128k-2025-02-19"`472473 - `"files-api-2025-04-14"`474475 - `"mcp-client-2025-04-04"`476477 - `"mcp-client-2025-11-20"`478479 - `"dev-full-thinking-2025-05-14"`480481 - `"interleaved-thinking-2025-05-14"`482483 - `"code-execution-2025-05-22"`484485 - `"extended-cache-ttl-2025-04-11"`486487 - `"context-1m-2025-08-07"`488489 - `"context-management-2025-06-27"`490491 - `"model-context-window-exceeded-2025-08-26"`492493 - `"skills-2025-10-02"`494495 - `"fast-mode-2026-02-01"`496497 - `"output-300k-2026-03-24"`498499 - `"user-profiles-2026-03-24"`500501 - `"user-profiles-2026-08-18"`502503 - `"user-profiles-2026-09-04"`504505 - `"advisor-tool-2026-03-01"`506507 - `"managed-agents-2026-04-01"`508509 - `"cache-diagnosis-2026-04-07"`510511 - `"dreaming-2026-04-21"`512513 - `"thinking-token-count-2026-05-13"`514515 - `"server-side-fallback-2026-06-01"`516517 - `"server-side-fallback-2026-07-01"`518519 - `"fallback-credit-2026-06-01"`520521 - `"fallback-credit-2026-07-01"`522523 - `"agent-memory-2026-07-22"`524525 - `"mid-conversation-tool-changes-2026-07-01"`526527 - `"compact-2026-01-12"`528529 - `"computer-use-2025-11-24"`530531 - `"mcp-tunnels-2026-06-22"`532533 - `"structured-outputs-2025-11-13"`534535 - `"task-budgets-2026-03-13"`536537 - `"thinking-display-updates-2026-08-18"`538539 - `"ce-user-management-2026-07-13"`540541 - `"mid-conversation-output-config-2026-07-01"`542543 - `"thinking-binding-controls-2026-08-01"`544545 - `"mid-conversation-system-clear-at-2026-08-21"`546547 - `"compact-2026-09-04"`548549- `"anthropic-workspace-id": optional string`550551### Returns552553- `BetaManagedAgentsDeploymentRun object`554555 A persistent, append-only record of a single deployment execution. Records session creation success or failure — no session lifecycle tracking.556557 - `type: "deployment_run"`558559 - `id: string`560561 Unique identifier for this run (`drun_...`).562563 - `agent: BetaManagedAgentsAgentReference`564565 A resolved agent reference with a concrete version.566567 - `type: "agent"`568569 - `id: string`570571 - `version: number`572573 format: int32574575 - `created_at: string`576577 A timestamp in RFC 3339 format578579 format: date-time580581 - `deployment_id: string`582583 ID of the deployment that produced this run.584585 - `error: BetaManagedAgentsEnvironmentArchivedRunError or BetaManagedAgentsAgentArchivedRunError or BetaManagedAgentsEnvironmentNotFoundRunError or 13 more or null`586587 Why the run failed to create a session. The type identifies the failure; message is human-readable detail.588589 - `BetaManagedAgentsEnvironmentArchivedRunError object`590591 The deployment's environment was archived.592593 - `type: "environment_archived_error"`594595 - `message: string`596597 Human-readable error description.598599 - `BetaManagedAgentsAgentArchivedRunError object`600601 The deployment's agent was archived.602603 - `type: "agent_archived_error"`604605 - `message: string`606607 Human-readable error description.608609 - `BetaManagedAgentsEnvironmentNotFoundRunError object`610611 The deployment's environment no longer exists.612613 - `type: "environment_not_found_error"`614615 - `message: string`616617 Human-readable error description.618619 - `BetaManagedAgentsVaultNotFoundRunError object`620621 A vault referenced by the deployment no longer exists.622623 - `type: "vault_not_found_error"`624625 - `message: string`626627 Human-readable error description.628629 - `BetaManagedAgentsVaultArchivedRunError object`630631 A vault referenced by the deployment is archived.632633 - `type: "vault_archived_error"`634635 - `message: string`636637 Human-readable error description.638639 - `BetaManagedAgentsFileNotFoundRunError object`640641 A file resource referenced by the deployment no longer exists.642643 - `type: "file_not_found_error"`644645 - `message: string`646647 Human-readable error description.648649 - `BetaManagedAgentsMemoryStoreArchivedRunError object`650651 A memory store referenced by the deployment is archived.652653 - `type: "memory_store_archived_error"`654655 - `message: string`656657 Human-readable error description.658659 - `BetaManagedAgentsSkillNotFoundRunError object`660661 A skill referenced by the deployment's agent no longer exists.662663 - `type: "skill_not_found_error"`664665 - `message: string`666667 Human-readable error description.668669 - `BetaManagedAgentsSessionResourceNotFoundRunError object`670671 A referenced resource no longer exists and its kind was not reported.672673 - `type: "session_resource_not_found_error"`674675 - `message: string`676677 Human-readable error description.678679 - `BetaManagedAgentsWorkspaceArchivedRunError object`680681 The deployment's workspace was archived.682683 - `type: "workspace_archived_error"`684685 - `message: string`686687 Human-readable error description.688689 - `BetaManagedAgentsOrganizationDisabledRunError object`690691 The deployment's organization is disabled.692693 - `type: "organization_disabled_error"`694695 - `message: string`696697 Human-readable error description.698699 - `BetaManagedAgentsSessionRateLimitedRunError object`700701 Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.702703 - `type: "session_rate_limited_error"`704705 - `message: string`706707 Human-readable error description.708709 - `BetaManagedAgentsSessionCreationRejectedRunError object`710711 The session create request was rejected with a non-retryable validation error.712713 - `type: "session_creation_rejected_error"`714715 - `message: string`716717 Human-readable error description.718719 - `BetaManagedAgentsUnknownRunError object`720721 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.722723 - `type: "unknown_error"`724725 - `message: string`726727 Human-readable error description.728729 - `BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object`730731 The deployment configures resources, but its environment is self-hosted and cannot mount them.732733 - `type: "self_hosted_resources_unsupported_error"`734735 - `message: string`736737 Human-readable error description.738739 - `BetaManagedAgentsMCPEgressBlockedRunError object`740741 An MCP server host used by the deployment's agent is blocked by the environment's network policy.742743 - `type: "mcp_egress_blocked_error"`744745 - `message: string`746747 Human-readable error description.748749 - `session_id: string or null`750751 Populated on success. Null on creation failure. Exactly one of `session_id` or `error` is non-null.752753 - `trigger_context: BetaManagedAgentsTriggerContext`754755 Describes what triggered a deployment run, with trigger-specific metadata.756757 - `BetaManagedAgentsScheduleTriggerContext object`758759 The run was fired by the deployment's cron schedule.760761 - `type: "schedule"`762763 - `scheduled_at: string`764765 A timestamp in RFC 3339 format766767 format: date-time768769 - `BetaManagedAgentsManualTriggerContext object`770771 The run was started manually by creating a session directly against the deployment.772773 - `type: "manual"`774775### Example776777```bash778curl https://api.anthropic.com/v1/deployment_runs/$DEPLOYMENT_RUN_ID \779 -H 'anthropic-version: 2023-06-01' \780 -H 'anthropic-beta: managed-agents-2026-04-01' \781 -H "X-Api-Key: $ANTHROPIC_API_KEY"782```783784#### Response (200)785786```json787{788 "id": "id",789 "agent": {790 "id": "agent_011CZkYqphY8vELVzwCUpqiQ",791 "type": "agent",792 "version": 1793 },794 "created_at": "2019-12-27T18:11:19.117Z",795 "deployment_id": "deployment_id",796 "error": {797 "message": "message",798 "type": "environment_archived_error"799 },800 "session_id": "session_id",801 "trigger_context": {802 "scheduled_at": "2019-12-27T18:11:19.117Z",803 "type": "schedule"804 },805 "type": "deployment_run"806}807```808809## Domain types810811### Beta Managed Agents Agent Archived Run Error812813- `BetaManagedAgentsAgentArchivedRunError object`814815 The deployment's agent was archived.816817 - `type: "agent_archived_error"`818819 - `message: string`820821 Human-readable error description.822823### Beta Managed Agents Deployment Run824825- `BetaManagedAgentsDeploymentRun object`826827 A persistent, append-only record of a single deployment execution. Records session creation success or failure — no session lifecycle tracking.828829 - `type: "deployment_run"`830831 - `id: string`832833 Unique identifier for this run (`drun_...`).834835 - `agent: BetaManagedAgentsAgentReference`836837 A resolved agent reference with a concrete version.838839 - `type: "agent"`840841 - `id: string`842843 - `version: number`844845 format: int32846847 - `created_at: string`848849 A timestamp in RFC 3339 format850851 format: date-time852853 - `deployment_id: string`854855 ID of the deployment that produced this run.856857 - `error: BetaManagedAgentsEnvironmentArchivedRunError or BetaManagedAgentsAgentArchivedRunError or BetaManagedAgentsEnvironmentNotFoundRunError or 13 more or null`858859 Why the run failed to create a session. The type identifies the failure; message is human-readable detail.860861 - `BetaManagedAgentsEnvironmentArchivedRunError object`862863 The deployment's environment was archived.864865 - `type: "environment_archived_error"`866867 - `message: string`868869 Human-readable error description.870871 - `BetaManagedAgentsAgentArchivedRunError object`872873 The deployment's agent was archived.874875 - `type: "agent_archived_error"`876877 - `message: string`878879 Human-readable error description.880881 - `BetaManagedAgentsEnvironmentNotFoundRunError object`882883 The deployment's environment no longer exists.884885 - `type: "environment_not_found_error"`886887 - `message: string`888889 Human-readable error description.890891 - `BetaManagedAgentsVaultNotFoundRunError object`892893 A vault referenced by the deployment no longer exists.894895 - `type: "vault_not_found_error"`896897 - `message: string`898899 Human-readable error description.900901 - `BetaManagedAgentsVaultArchivedRunError object`902903 A vault referenced by the deployment is archived.904905 - `type: "vault_archived_error"`906907 - `message: string`908909 Human-readable error description.910911 - `BetaManagedAgentsFileNotFoundRunError object`912913 A file resource referenced by the deployment no longer exists.914915 - `type: "file_not_found_error"`916917 - `message: string`918919 Human-readable error description.920921 - `BetaManagedAgentsMemoryStoreArchivedRunError object`922923 A memory store referenced by the deployment is archived.924925 - `type: "memory_store_archived_error"`926927 - `message: string`928929 Human-readable error description.930931 - `BetaManagedAgentsSkillNotFoundRunError object`932933 A skill referenced by the deployment's agent no longer exists.934935 - `type: "skill_not_found_error"`936937 - `message: string`938939 Human-readable error description.940941 - `BetaManagedAgentsSessionResourceNotFoundRunError object`942943 A referenced resource no longer exists and its kind was not reported.944945 - `type: "session_resource_not_found_error"`946947 - `message: string`948949 Human-readable error description.950951 - `BetaManagedAgentsWorkspaceArchivedRunError object`952953 The deployment's workspace was archived.954955 - `type: "workspace_archived_error"`956957 - `message: string`958959 Human-readable error description.960961 - `BetaManagedAgentsOrganizationDisabledRunError object`962963 The deployment's organization is disabled.964965 - `type: "organization_disabled_error"`966967 - `message: string`968969 Human-readable error description.970971 - `BetaManagedAgentsSessionRateLimitedRunError object`972973 Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.974975 - `type: "session_rate_limited_error"`976977 - `message: string`978979 Human-readable error description.980981 - `BetaManagedAgentsSessionCreationRejectedRunError object`982983 The session create request was rejected with a non-retryable validation error.984985 - `type: "session_creation_rejected_error"`986987 - `message: string`988989 Human-readable error description.990991 - `BetaManagedAgentsUnknownRunError object`992993 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.994995 - `type: "unknown_error"`996997 - `message: string`998999 Human-readable error description.10001001 - `BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object`10021003 The deployment configures resources, but its environment is self-hosted and cannot mount them.10041005 - `type: "self_hosted_resources_unsupported_error"`10061007 - `message: string`10081009 Human-readable error description.10101011 - `BetaManagedAgentsMCPEgressBlockedRunError object`10121013 An MCP server host used by the deployment's agent is blocked by the environment's network policy.10141015 - `type: "mcp_egress_blocked_error"`10161017 - `message: string`10181019 Human-readable error description.10201021 - `session_id: string or null`10221023 Populated on success. Null on creation failure. Exactly one of `session_id` or `error` is non-null.10241025 - `trigger_context: BetaManagedAgentsTriggerContext`10261027 Describes what triggered a deployment run, with trigger-specific metadata.10281029 - `BetaManagedAgentsScheduleTriggerContext object`10301031 The run was fired by the deployment's cron schedule.10321033 - `type: "schedule"`10341035 - `scheduled_at: string`10361037 A timestamp in RFC 3339 format10381039 format: date-time10401041 - `BetaManagedAgentsManualTriggerContext object`10421043 The run was started manually by creating a session directly against the deployment.10441045 - `type: "manual"`10461047### Beta Managed Agents Environment Archived Run Error10481049- `BetaManagedAgentsEnvironmentArchivedRunError object`10501051 The deployment's environment was archived.10521053 - `type: "environment_archived_error"`10541055 - `message: string`10561057 Human-readable error description.10581059### Beta Managed Agents Environment Not Found Run Error10601061- `BetaManagedAgentsEnvironmentNotFoundRunError object`10621063 The deployment's environment no longer exists.10641065 - `type: "environment_not_found_error"`10661067 - `message: string`10681069 Human-readable error description.10701071### Beta Managed Agents File Not Found Run Error10721073- `BetaManagedAgentsFileNotFoundRunError object`10741075 A file resource referenced by the deployment no longer exists.10761077 - `type: "file_not_found_error"`10781079 - `message: string`10801081 Human-readable error description.10821083### Beta Managed Agents Manual Trigger Context10841085- `BetaManagedAgentsManualTriggerContext object`10861087 The run was started manually by creating a session directly against the deployment.10881089 - `type: "manual"`10901091### Beta Managed Agents MCP Egress Blocked Run Error10921093- `BetaManagedAgentsMCPEgressBlockedRunError object`10941095 An MCP server host used by the deployment's agent is blocked by the environment's network policy.10961097 - `type: "mcp_egress_blocked_error"`10981099 - `message: string`11001101 Human-readable error description.11021103### Beta Managed Agents Memory Store Archived Run Error11041105- `BetaManagedAgentsMemoryStoreArchivedRunError object`11061107 A memory store referenced by the deployment is archived.11081109 - `type: "memory_store_archived_error"`11101111 - `message: string`11121113 Human-readable error description.11141115### Beta Managed Agents Organization Disabled Run Error11161117- `BetaManagedAgentsOrganizationDisabledRunError object`11181119 The deployment's organization is disabled.11201121 - `type: "organization_disabled_error"`11221123 - `message: string`11241125 Human-readable error description.11261127### Beta Managed Agents Schedule Trigger Context11281129- `BetaManagedAgentsScheduleTriggerContext object`11301131 The run was fired by the deployment's cron schedule.11321133 - `type: "schedule"`11341135 - `scheduled_at: string`11361137 A timestamp in RFC 3339 format11381139 format: date-time11401141### Beta Managed Agents Self Hosted Resources Unsupported Run Error11421143- `BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object`11441145 The deployment configures resources, but its environment is self-hosted and cannot mount them.11461147 - `type: "self_hosted_resources_unsupported_error"`11481149 - `message: string`11501151 Human-readable error description.11521153### Beta Managed Agents Session Creation Rejected Run Error11541155- `BetaManagedAgentsSessionCreationRejectedRunError object`11561157 The session create request was rejected with a non-retryable validation error.11581159 - `type: "session_creation_rejected_error"`11601161 - `message: string`11621163 Human-readable error description.11641165### Beta Managed Agents Session Rate Limited Run Error11661167- `BetaManagedAgentsSessionRateLimitedRunError object`11681169 Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.11701171 - `type: "session_rate_limited_error"`11721173 - `message: string`11741175 Human-readable error description.11761177### Beta Managed Agents Session Resource Not Found Run Error11781179- `BetaManagedAgentsSessionResourceNotFoundRunError object`11801181 A referenced resource no longer exists and its kind was not reported.11821183 - `type: "session_resource_not_found_error"`11841185 - `message: string`11861187 Human-readable error description.11881189### Beta Managed Agents Skill Not Found Run Error11901191- `BetaManagedAgentsSkillNotFoundRunError object`11921193 A skill referenced by the deployment's agent no longer exists.11941195 - `type: "skill_not_found_error"`11961197 - `message: string`11981199 Human-readable error description.12001201### Beta Managed Agents Trigger Context12021203- `BetaManagedAgentsTriggerContext = BetaManagedAgentsScheduleTriggerContext or BetaManagedAgentsManualTriggerContext`12041205 Describes what triggered a deployment run, with trigger-specific metadata.12061207 - `BetaManagedAgentsScheduleTriggerContext object`12081209 The run was fired by the deployment's cron schedule.12101211 - `type: "schedule"`12121213 - `scheduled_at: string`12141215 A timestamp in RFC 3339 format12161217 format: date-time12181219 - `BetaManagedAgentsManualTriggerContext object`12201221 The run was started manually by creating a session directly against the deployment.12221223 - `type: "manual"`12241225### Beta Managed Agents Trigger Type12261227- `BetaManagedAgentsTriggerType = "schedule" or "manual"`12281229 What triggered a deployment run.12301231 - `"schedule"`12321233 - `"manual"`12341235### Beta Managed Agents Unknown Run Error12361237- `BetaManagedAgentsUnknownRunError object`12381239 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.12401241 - `type: "unknown_error"`12421243 - `message: string`12441245 Human-readable error description.12461247### Beta Managed Agents Vault Archived Run Error12481249- `BetaManagedAgentsVaultArchivedRunError object`12501251 A vault referenced by the deployment is archived.12521253 - `type: "vault_archived_error"`12541255 - `message: string`12561257 Human-readable error description.12581259### Beta Managed Agents Vault Not Found Run Error12601261- `BetaManagedAgentsVaultNotFoundRunError object`12621263 A vault referenced by the deployment no longer exists.12641265 - `type: "vault_not_found_error"`12661267 - `message: string`12681269 Human-readable error description.12701271### Beta Managed Agents Workspace Archived Run Error12721273- `BetaManagedAgentsWorkspaceArchivedRunError object`12741275 The deployment's workspace was archived.12761277 - `type: "workspace_archived_error"`12781279 - `message: string`12801281 Human-readable error description.1282