spb/doc-api

1---2title: Deployments3url: https://platform.claude.com/docs/en/api/beta/deployments4---56# Deployments78## Create Deployment910**POST** `/v1/deployments`1112Create Deployment1314### Headers1516- `"anthropic-beta": optional array of AnthropicBeta`1718  Optional header to specify the beta version(s) you want to use.1920  - `string`2122  - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`2324    - `"message-batches-2024-09-24"`2526    - `"prompt-caching-2024-07-31"`2728    - `"computer-use-2024-10-22"`2930    - `"computer-use-2025-01-24"`3132    - `"pdfs-2024-09-25"`3334    - `"token-counting-2024-11-01"`3536    - `"token-efficient-tools-2025-02-19"`3738    - `"output-128k-2025-02-19"`3940    - `"files-api-2025-04-14"`4142    - `"mcp-client-2025-04-04"`4344    - `"mcp-client-2025-11-20"`4546    - `"dev-full-thinking-2025-05-14"`4748    - `"interleaved-thinking-2025-05-14"`4950    - `"code-execution-2025-05-22"`5152    - `"extended-cache-ttl-2025-04-11"`5354    - `"context-1m-2025-08-07"`5556    - `"context-management-2025-06-27"`5758    - `"model-context-window-exceeded-2025-08-26"`5960    - `"skills-2025-10-02"`6162    - `"fast-mode-2026-02-01"`6364    - `"output-300k-2026-03-24"`6566    - `"user-profiles-2026-03-24"`6768    - `"user-profiles-2026-08-18"`6970    - `"user-profiles-2026-09-04"`7172    - `"advisor-tool-2026-03-01"`7374    - `"managed-agents-2026-04-01"`7576    - `"cache-diagnosis-2026-04-07"`7778    - `"dreaming-2026-04-21"`7980    - `"thinking-token-count-2026-05-13"`8182    - `"server-side-fallback-2026-06-01"`8384    - `"server-side-fallback-2026-07-01"`8586    - `"fallback-credit-2026-06-01"`8788    - `"fallback-credit-2026-07-01"`8990    - `"agent-memory-2026-07-22"`9192    - `"mid-conversation-tool-changes-2026-07-01"`9394    - `"compact-2026-01-12"`9596    - `"computer-use-2025-11-24"`9798    - `"mcp-tunnels-2026-06-22"`99100    - `"structured-outputs-2025-11-13"`101102    - `"task-budgets-2026-03-13"`103104    - `"thinking-display-updates-2026-08-18"`105106    - `"ce-user-management-2026-07-13"`107108    - `"mid-conversation-output-config-2026-07-01"`109110    - `"thinking-binding-controls-2026-08-01"`111112    - `"mid-conversation-system-clear-at-2026-08-21"`113114    - `"compact-2026-09-04"`115116- `"anthropic-workspace-id": optional string`117118### Body parameters119120- `agent: string or BetaManagedAgentsAgentParams`121122  Agent to deploy. Accepts the `agent` ID string, which pins the latest version, or an `agent` object with both id and version specified. The agent must exist and not be archived.123124  - `string`125126  - `BetaManagedAgentsAgentParams object`127128    Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version129130    - `type: "agent"`131132    - `id: string`133134      The `agent` ID.135136      minLength: 1, maxLength: 128137138    - `version: optional number`139140      The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified.141142      format: int32143144- `environment_id: string`145146  ID of the `environment` defining the container configuration for sessions created from this deployment.147148  minLength: 1, maxLength: 128149150- `initial_events: array of BetaManagedAgentsDeploymentInitialEventParams`151152  Events to send to each session immediately after creation. At least 1, maximum 50.153154  - `BetaManagedAgentsUserMessageEventParams object`155156    Parameters for sending a user message to the session.157158    - `type: "user.message"`159160    - `content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsRedactedBlock`161162      Array of content blocks for the user message.163164      - `BetaManagedAgentsTextBlock object`165166        Regular text content.167168        - `type: "text"`169170        - `text: string`171172          The text content.173174          minLength: 1175176      - `BetaManagedAgentsImageBlock object`177178        Image content specified directly as base64 data or as a reference via a URL.179180        - `type: "image"`181182        - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`183184          Union type for image source variants.185186          - `BetaManagedAgentsBase64ImageSource object`187188            Base64-encoded image data.189190            - `type: "base64"`191192            - `data: string`193194              Base64-encoded image data.195196              minLength: 1197198            - `media_type: string`199200              MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").201202              minLength: 1203204          - `BetaManagedAgentsURLImageSource object`205206            Image referenced by URL.207208            - `type: "url"`209210            - `url: string`211212              URL of the image to fetch.213214              minLength: 1215216          - `BetaManagedAgentsFileImageSource object`217218            Image referenced by file ID.219220            - `type: "file"`221222            - `file_id: string`223224              ID of a previously uploaded file.225226              minLength: 1227228      - `BetaManagedAgentsDocumentBlock object`229230        Document content, either specified directly as base64 data, as text, or as a reference via a URL.231232        - `type: "document"`233234        - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`235236          Union type for document source variants.237238          - `BetaManagedAgentsBase64DocumentSource object`239240            Base64-encoded document data.241242            - `type: "base64"`243244            - `data: string`245246              Base64-encoded document data.247248              minLength: 1249250            - `media_type: string`251252              MIME type of the document (e.g., "application/pdf").253254              minLength: 1255256          - `BetaManagedAgentsPlainTextDocumentSource object`257258            Plain text document content.259260            - `type: "text"`261262            - `data: string`263264              The plain text content.265266              minLength: 1267268            - `media_type: "text/plain"`269270              MIME type of the text content. Must be "text/plain".271272          - `BetaManagedAgentsURLDocumentSource object`273274            Document referenced by URL.275276            - `type: "url"`277278            - `url: string`279280              URL of the document to fetch.281282              minLength: 1283284          - `BetaManagedAgentsFileDocumentSource object`285286            Document referenced by file ID.287288            - `type: "file"`289290            - `file_id: string`291292              ID of a previously uploaded file.293294              minLength: 1295296        - `context: optional string or null`297298          Additional context about the document for the model.299300        - `title: optional string or null`301302          The title of the document.303304      - `BetaManagedAgentsRedactedBlock object`305306        Placeholder for content withheld by Anthropic model policy.307308        - `type: "redacted"`309310  - `BetaManagedAgentsUserDefineOutcomeEventParams object`311312    Parameters for defining an outcome the agent should work toward. The agent begins work on receipt.313314    - `type: "user.define_outcome"`315316    - `description: string`317318      What the agent should produce. This is the task specification.319320    - `rubric: BetaManagedAgentsFileRubricParams or BetaManagedAgentsTextRubricParams`321322      Rubric for grading the quality of an outcome.323324      - `BetaManagedAgentsFileRubricParams object`325326        Rubric referenced by a file uploaded via the Files API.327328        - `type: "file"`329330        - `file_id: string`331332          ID of the rubric file.333334      - `BetaManagedAgentsTextRubricParams object`335336        Rubric content provided inline as text.337338        - `type: "text"`339340        - `content: string`341342          Rubric content. Plain text or markdown — the grader treats it as freeform text. Maximum 262144 characters.343344          maxLength: 262144345346    - `max_iterations: optional number or null`347348      Eval→revision cycles before giving up. Default 3, max 20.349350      format: int32351352  - `BetaManagedAgentsSystemMessageEventParams object`353354    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.355356    - `type: "system.message"`357358    - `content: array of BetaManagedAgentsSystemContentBlock`359360      System content blocks to append. Text-only.361362      - `type: "text"`363364      - `text: string`365366        The text content.367368        minLength: 1369370- `name: string`371372  Human-readable name for the deployment.373374  minLength: 1, maxLength: 256375376- `budget: optional BetaManagedAgentsBudgetLimit or null`377378  A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.379380  - `type: "limit"`381382  - `max_list_cost: BetaMonetaryAmount`383384    A monetary amount in a specific currency.385386    - `amount: string`387388      Amount in minor units of the currency, as an integer decimal string with no leading zeros: "2500" is $25.00 and "50" is fifty cents. A string rather than a number so no float rounding is ever applied.389390    - `currency: BetaCurrency`391392      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.393394- `description: optional string or null`395396  Description of what the deployment does.397398  maxLength: 2048399400- `metadata: optional map[string]`401402  Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.403404- `resources: optional array of BetaManagedAgentsGitHubRepositoryResourceParams or BetaManagedAgentsFileResourceParams or BetaManagedAgentsMemoryStoreResourceParam`405406  Resources (e.g. repositories, files) to mount into each session's container. Maximum 500.407408  - `BetaManagedAgentsGitHubRepositoryResourceParams object`409410    Mount a GitHub repository into the session's container.411412    - `type: "github_repository"`413414    - `url: string`415416      Github URL of the repository417418      minLength: 1, maxLength: 2048419420    - `authorization_token: optional string`421422      GitHub authorization token used to clone the repository. Required for private repositories; optional for public ones.423424      minLength: 1, maxLength: 4096425426    - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`427428      Branch or commit to check out. Defaults to the repository's default branch.429430      - `BetaManagedAgentsBranchCheckout object`431432        - `type: "branch"`433434        - `name: string`435436          Branch name to check out.437438          minLength: 1, maxLength: 255439440      - `BetaManagedAgentsCommitCheckout object`441442        - `type: "commit"`443444        - `sha: string`445446          Full commit SHA to check out.447448          minLength: 7, maxLength: 64449450    - `mount_path: optional string or null`451452      Mount path in the container. Defaults to `/workspace/<repo-name>`.453454      minLength: 1, maxLength: 4096455456  - `BetaManagedAgentsFileResourceParams object`457458    Mount a file uploaded via the Files API into the session.459460    - `type: "file"`461462    - `file_id: string`463464      ID of a previously uploaded file.465466      minLength: 1, maxLength: 128467468    - `mount_path: optional string or null`469470      Mount path in the container. Defaults to `/mnt/session/uploads/<file_id>`.471472      minLength: 1, maxLength: 4096473474  - `BetaManagedAgentsMemoryStoreResourceParam object`475476    Parameters for attaching a memory store to an agent session.477478    - `type: "memory_store"`479480    - `memory_store_id: string`481482      The memory store ID (memstore_...). Must belong to the caller's organization and workspace.483484    - `access: optional "read_write" or "read_only" or null`485486      Access mode for an attached memory store.487488      - `"read_write"`489490      - `"read_only"`491492    - `instructions: optional string or null`493494      Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.495496      maxLength: 4096497498- `schedule: optional BetaManagedAgentsScheduleParams or null`499500  5-field POSIX cron schedule. Literal wall-clock matching in the configured timezone.501502  - `type: "cron"`503504  - `expression: string`505506    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).507508    minLength: 1, maxLength: 256509510  - `timezone: string`511512    Required. IANA timezone identifier (e.g., "America/Los_Angeles", "UTC"). Validated against the IANA timezone database.513514    minLength: 1515516- `vault_ids: optional array of string`517518  Vault IDs for stored credentials the agent can use during sessions created from this deployment. Maximum 50.519520### Returns521522- `BetaManagedAgentsDeployment object`523524  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.525526  - `type: "deployment"`527528  - `id: string`529530    Unique identifier for this deployment.531532  - `agent: BetaManagedAgentsAgentReference`533534    A resolved agent reference with a concrete version.535536    - `type: "agent"`537538    - `id: string`539540    - `version: number`541542      format: int32543544  - `archived_at: string or null`545546    A timestamp in RFC 3339 format547548    format: date-time549550  - `created_at: string`551552    A timestamp in RFC 3339 format553554    format: date-time555556  - `description: string or null`557558    Description of what the deployment does.559560  - `environment_id: string`561562    ID of the `environment` where sessions run.563564  - `initial_events: array of BetaManagedAgentsDeploymentInitialEvent`565566    Events sent to each session immediately after creation.567568    - `BetaManagedAgentsDeploymentUserMessageEvent object`569570      A user message sent to the session.571572      - `type: "user.message"`573574      - `content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsRedactedBlock`575576        Array of content blocks for the user message.577578        - `BetaManagedAgentsTextBlock object`579580          Regular text content.581582          - `type: "text"`583584          - `text: string`585586            The text content.587588            minLength: 1589590        - `BetaManagedAgentsImageBlock object`591592          Image content specified directly as base64 data or as a reference via a URL.593594          - `type: "image"`595596          - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`597598            Union type for image source variants.599600            - `BetaManagedAgentsBase64ImageSource object`601602              Base64-encoded image data.603604              - `type: "base64"`605606              - `data: string`607608                Base64-encoded image data.609610                minLength: 1611612              - `media_type: string`613614                MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").615616                minLength: 1617618            - `BetaManagedAgentsURLImageSource object`619620              Image referenced by URL.621622              - `type: "url"`623624              - `url: string`625626                URL of the image to fetch.627628                minLength: 1629630            - `BetaManagedAgentsFileImageSource object`631632              Image referenced by file ID.633634              - `type: "file"`635636              - `file_id: string`637638                ID of a previously uploaded file.639640                minLength: 1641642        - `BetaManagedAgentsDocumentBlock object`643644          Document content, either specified directly as base64 data, as text, or as a reference via a URL.645646          - `type: "document"`647648          - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`649650            Union type for document source variants.651652            - `BetaManagedAgentsBase64DocumentSource object`653654              Base64-encoded document data.655656              - `type: "base64"`657658              - `data: string`659660                Base64-encoded document data.661662                minLength: 1663664              - `media_type: string`665666                MIME type of the document (e.g., "application/pdf").667668                minLength: 1669670            - `BetaManagedAgentsPlainTextDocumentSource object`671672              Plain text document content.673674              - `type: "text"`675676              - `data: string`677678                The plain text content.679680                minLength: 1681682              - `media_type: "text/plain"`683684                MIME type of the text content. Must be "text/plain".685686            - `BetaManagedAgentsURLDocumentSource object`687688              Document referenced by URL.689690              - `type: "url"`691692              - `url: string`693694                URL of the document to fetch.695696                minLength: 1697698            - `BetaManagedAgentsFileDocumentSource object`699700              Document referenced by file ID.701702              - `type: "file"`703704              - `file_id: string`705706                ID of a previously uploaded file.707708                minLength: 1709710          - `context: optional string or null`711712            Additional context about the document for the model.713714          - `title: optional string or null`715716            The title of the document.717718        - `BetaManagedAgentsRedactedBlock object`719720          Placeholder for content withheld by Anthropic model policy.721722          - `type: "redacted"`723724    - `BetaManagedAgentsDeploymentUserDefineOutcomeEvent object`725726      An outcome the agent should work toward. The agent begins work on receipt.727728      - `type: "user.define_outcome"`729730      - `description: string`731732        What the agent should produce. This is the task specification.733734      - `rubric: BetaManagedAgentsFileRubric or BetaManagedAgentsTextRubric`735736        Rubric for grading the quality of an outcome.737738        - `BetaManagedAgentsFileRubric object`739740          Rubric referenced by a file uploaded via the Files API.741742          - `type: "file"`743744          - `file_id: string`745746            ID of the rubric file.747748        - `BetaManagedAgentsTextRubric object`749750          Rubric content provided inline as text.751752          - `type: "text"`753754          - `content: string`755756            Rubric content. Plain text or markdown — the grader treats it as freeform text.757758      - `max_iterations: optional number or null`759760        Eval→revision cycles before giving up. Default 3, max 20.761762        format: int32763764    - `BetaManagedAgentsDeploymentSystemMessageEvent object`765766      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.767768      - `type: "system.message"`769770      - `content: array of BetaManagedAgentsSystemContentBlock`771772        System content blocks to append. Text-only.773774        - `type: "text"`775776        - `text: string`777778          The text content.779780          minLength: 1781782  - `metadata: map[string]`783784    Arbitrary key-value metadata. Maximum 16 pairs.785786  - `name: string`787788    Human-readable name.789790  - `paused_reason: BetaManagedAgentsDeploymentPausedReason or null`791792    Why a deployment is paused. Non-null exactly when `status` is `paused`.793794    - `BetaManagedAgentsManualDeploymentPausedReason object`795796      The caller invoked the pause endpoint on the deployment.797798      - `type: "manual"`799800    - `BetaManagedAgentsErrorDeploymentPausedReason object`801802      A scheduled fire recorded a failed run whose error auto-pauses the deployment.803804      - `type: "error"`805806      - `error: BetaManagedAgentsDeploymentPausedReasonError`807808        The error that triggered an auto-pause. Matches the failed run's `error.type`.809810        - `BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError object`811812          The deployment's environment was archived.813814          - `type: "environment_archived_error"`815816        - `BetaManagedAgentsAgentArchivedDeploymentPausedReasonError object`817818          The deployment's agent was archived.819820          - `type: "agent_archived_error"`821822        - `BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError object`823824          The deployment's environment no longer exists.825826          - `type: "environment_not_found_error"`827828        - `BetaManagedAgentsVaultNotFoundDeploymentPausedReasonError object`829830          A vault referenced by the deployment no longer exists.831832          - `type: "vault_not_found_error"`833834        - `BetaManagedAgentsFileNotFoundDeploymentPausedReasonError object`835836          A file resource referenced by the deployment no longer exists.837838          - `type: "file_not_found_error"`839840        - `BetaManagedAgentsSessionResourceNotFoundDeploymentPausedReasonError object`841842          A referenced resource no longer exists and its kind was not reported.843844          - `type: "session_resource_not_found_error"`845846        - `BetaManagedAgentsWorkspaceArchivedDeploymentPausedReasonError object`847848          The deployment's workspace was archived.849850          - `type: "workspace_archived_error"`851852        - `BetaManagedAgentsOrganizationDisabledDeploymentPausedReasonError object`853854          The deployment's organization is disabled.855856          - `type: "organization_disabled_error"`857858        - `BetaManagedAgentsMemoryStoreArchivedDeploymentPausedReasonError object`859860          A memory store referenced by the deployment is archived.861862          - `type: "memory_store_archived_error"`863864        - `BetaManagedAgentsSkillNotFoundDeploymentPausedReasonError object`865866          A skill referenced by the deployment's agent no longer exists.867868          - `type: "skill_not_found_error"`869870        - `BetaManagedAgentsVaultArchivedDeploymentPausedReasonError object`871872          A vault referenced by the deployment is archived.873874          - `type: "vault_archived_error"`875876        - `BetaManagedAgentsUnknownDeploymentPausedReasonError object`877878          An unrecognized error auto-paused the deployment. A fallback variant; matches a run whose `error.type` is `unknown_error`.879880          - `type: "unknown_error"`881882        - `BetaManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonError object`883884          The deployment configures resources, but its environment is self-hosted and cannot mount them.885886          - `type: "self_hosted_resources_unsupported_error"`887888        - `BetaManagedAgentsMCPEgressBlockedDeploymentPausedReasonError object`889890          An MCP server host used by the deployment's agent is blocked by the environment's network policy.891892          - `type: "mcp_egress_blocked_error"`893894  - `resources: array of BetaManagedAgentsSessionResourceConfig`895896    Resources attached to sessions created from this deployment. Echoes the input minus write-only credentials.897898    - `BetaManagedAgentsGitHubRepositoryResourceConfig object`899900      A GitHub repository mounted into each session's container. The authorization token is write-only and never returned.901902      - `type: "github_repository"`903904      - `url: string`905906        Github URL of the repository907908      - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`909910        Branch or commit to check out. Defaults to the repository's default branch.911912        - `BetaManagedAgentsBranchCheckout object`913914          - `type: "branch"`915916          - `name: string`917918            Branch name to check out.919920            minLength: 1, maxLength: 255921922        - `BetaManagedAgentsCommitCheckout object`923924          - `type: "commit"`925926          - `sha: string`927928            Full commit SHA to check out.929930            minLength: 7, maxLength: 64931932      - `mount_path: optional string or null`933934        Mount path in the container. Defaults to `/workspace/<repo-name>`.935936    - `BetaManagedAgentsFileResourceConfig object`937938      A file mounted into each session's container.939940      - `type: "file"`941942      - `file_id: string`943944        ID of a previously uploaded file.945946      - `mount_path: optional string or null`947948        Mount path in the container. Defaults to `/mnt/session/uploads/<file_id>`.949950    - `BetaManagedAgentsMemoryStoreResourceConfig object`951952      A memory store attached to each session created from this deployment.953954      - `type: "memory_store"`955956      - `memory_store_id: string`957958        The memory store ID (memstore_...). Must belong to the caller's organization and workspace.959960      - `access: optional "read_write" or "read_only" or null`961962        Access mode for an attached memory store.963964        - `"read_write"`965966        - `"read_only"`967968      - `instructions: optional string or null`969970        Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.971972  - `schedule: BetaManagedAgentsSchedule or null`973974    5-field POSIX cron schedule with computed runtime timestamps.975976    - `type: "cron"`977978    - `expression: string`979980      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).981982      minLength: 1, maxLength: 256983984    - `timezone: string`985986      IANA timezone identifier (e.g., "America/Los_Angeles", "UTC").987988      minLength: 1989990    - `last_run_at: optional string or null`991992      A timestamp in RFC 3339 format993994      format: date-time995996    - `upcoming_runs_at: optional array of string`997998      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.9991000  - `status: BetaManagedAgentsDeploymentStatus`10011002    Lifecycle status of a deployment.10031004    - `"active"`10051006    - `"paused"`10071008  - `updated_at: string`10091010    A timestamp in RFC 3339 format10111012    format: date-time10131014  - `vault_ids: array of string`10151016    Vault IDs supplying stored credentials for sessions created from this deployment.10171018  - `budget: optional BetaManagedAgentsBudgetLimit or null`10191020    A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.10211022    - `type: "limit"`10231024    - `max_list_cost: BetaMonetaryAmount`10251026      A monetary amount in a specific currency.10271028      - `amount: string`10291030        Amount in minor units of the currency, as an integer decimal string with no leading zeros: "2500" is $25.00 and "50" is fifty cents. A string rather than a number so no float rounding is ever applied.10311032      - `currency: BetaCurrency`10331034        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.10351036### Example10371038```bash1039curl https://api.anthropic.com/v1/deployments \1040    -H 'Content-Type: application/json' \1041    -H 'anthropic-version: 2023-06-01' \1042    -H 'anthropic-beta: managed-agents-2026-04-01' \1043    -H "X-Api-Key: $ANTHROPIC_API_KEY" \1044    -d '{1045          "agent": "string",1046          "environment_id": "x",1047          "initial_events": [1048            {1049              "content": [1050                {1051                  "text": "Where is my order #1234?",1052                  "type": "text"1053                }1054              ],1055              "type": "user.message"1056            }1057          ],1058          "name": "x"1059        }'1060```10611062#### Response (200)10631064```json1065{1066  "id": "depl_011CZkZcDH3vPqd7xnEfwTai",1067  "agent": {1068    "id": "agent_011CZkYpogX7uDKUyvBTophP",1069    "type": "agent",1070    "version": 11071  },1072  "archived_at": null,1073  "created_at": "2026-03-15T10:00:00Z",1074  "description": "Compiles yesterday's orders into a report every weekday morning.",1075  "environment_id": "env_011CZkZ9X2dpNyB7HsEFoRfW",1076  "initial_events": [1077    {1078      "content": [1079        {1080          "text": "Compile yesterday's orders into report.md.",1081          "type": "text"1082        }1083      ],1084      "type": "user.message"1085    }1086  ],1087  "metadata": {},1088  "name": "Daily order report",1089  "paused_reason": {1090    "type": "manual"1091  },1092  "resources": [1093    {1094      "type": "github_repository",1095      "url": "url",1096      "checkout": {1097        "name": "main",1098        "type": "branch"1099      },1100      "mount_path": "mount_path"1101    }1102  ],1103  "schedule": {1104    "expression": "0 9 * * 1-5",1105    "timezone": "America/Los_Angeles",1106    "type": "cron",1107    "last_run_at": "2026-03-16T16:00:09Z",1108    "upcoming_runs_at": [1109      "2026-03-17T16:00:00Z",1110      "2026-03-18T16:00:00Z"1111    ]1112  },1113  "status": "active",1114  "type": "deployment",1115  "updated_at": "2026-03-15T10:00:00Z",1116  "vault_ids": [1117    "vlt_011CZkZDLs7fYzm1hXNPeRjv"1118  ],1119  "budget": {1120    "max_list_cost": {1121      "amount": "2500",1122      "currency": "USD"1123    },1124    "type": "limit"1125  }1126}1127```11281129## List Deployments11301131**GET** `/v1/deployments`11321133List Deployments11341135### Query parameters11361137- `agent_id: optional string`11381139  Filter by agent ID.11401141- `"created_at[gte]": optional string`11421143  Return deployments created at or after this time (inclusive).11441145  format: date-time11461147- `"created_at[lte]": optional string`11481149  Return deployments created at or before this time (inclusive).11501151  format: date-time11521153- `include_archived: optional boolean`11541155  When true, includes archived deployments. Default: false (exclude archived).11561157- `limit: optional number`11581159  Maximum results per page. Default 20, maximum 100.11601161  format: int3211621163- `page: optional string`11641165  Opaque pagination cursor.11661167- `status: optional BetaManagedAgentsDeploymentStatus`11681169  Filter by status: `active` or `paused`. Omit for both. To include archived deployments, use `include_archived` instead; the two cannot be combined.11701171  - `"active"`11721173  - `"paused"`11741175### Headers11761177- `"anthropic-beta": optional array of AnthropicBeta`11781179  Optional header to specify the beta version(s) you want to use.11801181  - `string`11821183  - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`11841185    - `"message-batches-2024-09-24"`11861187    - `"prompt-caching-2024-07-31"`11881189    - `"computer-use-2024-10-22"`11901191    - `"computer-use-2025-01-24"`11921193    - `"pdfs-2024-09-25"`11941195    - `"token-counting-2024-11-01"`11961197    - `"token-efficient-tools-2025-02-19"`11981199    - `"output-128k-2025-02-19"`12001201    - `"files-api-2025-04-14"`12021203    - `"mcp-client-2025-04-04"`12041205    - `"mcp-client-2025-11-20"`12061207    - `"dev-full-thinking-2025-05-14"`12081209    - `"interleaved-thinking-2025-05-14"`12101211    - `"code-execution-2025-05-22"`12121213    - `"extended-cache-ttl-2025-04-11"`12141215    - `"context-1m-2025-08-07"`12161217    - `"context-management-2025-06-27"`12181219    - `"model-context-window-exceeded-2025-08-26"`12201221    - `"skills-2025-10-02"`12221223    - `"fast-mode-2026-02-01"`12241225    - `"output-300k-2026-03-24"`12261227    - `"user-profiles-2026-03-24"`12281229    - `"user-profiles-2026-08-18"`12301231    - `"user-profiles-2026-09-04"`12321233    - `"advisor-tool-2026-03-01"`12341235    - `"managed-agents-2026-04-01"`12361237    - `"cache-diagnosis-2026-04-07"`12381239    - `"dreaming-2026-04-21"`12401241    - `"thinking-token-count-2026-05-13"`12421243    - `"server-side-fallback-2026-06-01"`12441245    - `"server-side-fallback-2026-07-01"`12461247    - `"fallback-credit-2026-06-01"`12481249    - `"fallback-credit-2026-07-01"`12501251    - `"agent-memory-2026-07-22"`12521253    - `"mid-conversation-tool-changes-2026-07-01"`12541255    - `"compact-2026-01-12"`12561257    - `"computer-use-2025-11-24"`12581259    - `"mcp-tunnels-2026-06-22"`12601261    - `"structured-outputs-2025-11-13"`12621263    - `"task-budgets-2026-03-13"`12641265    - `"thinking-display-updates-2026-08-18"`12661267    - `"ce-user-management-2026-07-13"`12681269    - `"mid-conversation-output-config-2026-07-01"`12701271    - `"thinking-binding-controls-2026-08-01"`12721273    - `"mid-conversation-system-clear-at-2026-08-21"`12741275    - `"compact-2026-09-04"`12761277- `"anthropic-workspace-id": optional string`12781279### Returns12801281- `data: array of BetaManagedAgentsDeployment`12821283  List of deployments.12841285  - `type: "deployment"`12861287  - `id: string`12881289    Unique identifier for this deployment.12901291  - `agent: BetaManagedAgentsAgentReference`12921293    A resolved agent reference with a concrete version.12941295    - `type: "agent"`12961297    - `id: string`12981299    - `version: number`13001301      format: int3213021303  - `archived_at: string or null`13041305    A timestamp in RFC 3339 format13061307    format: date-time13081309  - `created_at: string`13101311    A timestamp in RFC 3339 format13121313    format: date-time13141315  - `description: string or null`13161317    Description of what the deployment does.13181319  - `environment_id: string`13201321    ID of the `environment` where sessions run.13221323  - `initial_events: array of BetaManagedAgentsDeploymentInitialEvent`13241325    Events sent to each session immediately after creation.13261327    - `BetaManagedAgentsDeploymentUserMessageEvent object`13281329      A user message sent to the session.13301331      - `type: "user.message"`13321333      - `content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsRedactedBlock`13341335        Array of content blocks for the user message.13361337        - `BetaManagedAgentsTextBlock object`13381339          Regular text content.13401341          - `type: "text"`13421343          - `text: string`13441345            The text content.13461347            minLength: 113481349        - `BetaManagedAgentsImageBlock object`13501351          Image content specified directly as base64 data or as a reference via a URL.13521353          - `type: "image"`13541355          - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`13561357            Union type for image source variants.13581359            - `BetaManagedAgentsBase64ImageSource object`13601361              Base64-encoded image data.13621363              - `type: "base64"`13641365              - `data: string`13661367                Base64-encoded image data.13681369                minLength: 113701371              - `media_type: string`13721373                MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").13741375                minLength: 113761377            - `BetaManagedAgentsURLImageSource object`13781379              Image referenced by URL.13801381              - `type: "url"`13821383              - `url: string`13841385                URL of the image to fetch.13861387                minLength: 113881389            - `BetaManagedAgentsFileImageSource object`13901391              Image referenced by file ID.13921393              - `type: "file"`13941395              - `file_id: string`13961397                ID of a previously uploaded file.13981399                minLength: 114001401        - `BetaManagedAgentsDocumentBlock object`14021403          Document content, either specified directly as base64 data, as text, or as a reference via a URL.14041405          - `type: "document"`14061407          - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`14081409            Union type for document source variants.14101411            - `BetaManagedAgentsBase64DocumentSource object`14121413              Base64-encoded document data.14141415              - `type: "base64"`14161417              - `data: string`14181419                Base64-encoded document data.14201421                minLength: 114221423              - `media_type: string`14241425                MIME type of the document (e.g., "application/pdf").14261427                minLength: 114281429            - `BetaManagedAgentsPlainTextDocumentSource object`14301431              Plain text document content.14321433              - `type: "text"`14341435              - `data: string`14361437                The plain text content.14381439                minLength: 114401441              - `media_type: "text/plain"`14421443                MIME type of the text content. Must be "text/plain".14441445            - `BetaManagedAgentsURLDocumentSource object`14461447              Document referenced by URL.14481449              - `type: "url"`14501451              - `url: string`14521453                URL of the document to fetch.14541455                minLength: 114561457            - `BetaManagedAgentsFileDocumentSource object`14581459              Document referenced by file ID.14601461              - `type: "file"`14621463              - `file_id: string`14641465                ID of a previously uploaded file.14661467                minLength: 114681469          - `context: optional string or null`14701471            Additional context about the document for the model.14721473          - `title: optional string or null`14741475            The title of the document.14761477        - `BetaManagedAgentsRedactedBlock object`14781479          Placeholder for content withheld by Anthropic model policy.14801481          - `type: "redacted"`14821483    - `BetaManagedAgentsDeploymentUserDefineOutcomeEvent object`14841485      An outcome the agent should work toward. The agent begins work on receipt.14861487      - `type: "user.define_outcome"`14881489      - `description: string`14901491        What the agent should produce. This is the task specification.14921493      - `rubric: BetaManagedAgentsFileRubric or BetaManagedAgentsTextRubric`14941495        Rubric for grading the quality of an outcome.14961497        - `BetaManagedAgentsFileRubric object`14981499          Rubric referenced by a file uploaded via the Files API.15001501          - `type: "file"`15021503          - `file_id: string`15041505            ID of the rubric file.15061507        - `BetaManagedAgentsTextRubric object`15081509          Rubric content provided inline as text.15101511          - `type: "text"`15121513          - `content: string`15141515            Rubric content. Plain text or markdown — the grader treats it as freeform text.15161517      - `max_iterations: optional number or null`15181519        Eval→revision cycles before giving up. Default 3, max 20.15201521        format: int3215221523    - `BetaManagedAgentsDeploymentSystemMessageEvent object`15241525      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.15261527      - `type: "system.message"`15281529      - `content: array of BetaManagedAgentsSystemContentBlock`15301531        System content blocks to append. Text-only.15321533        - `type: "text"`15341535        - `text: string`15361537          The text content.15381539          minLength: 115401541  - `metadata: map[string]`15421543    Arbitrary key-value metadata. Maximum 16 pairs.15441545  - `name: string`15461547    Human-readable name.15481549  - `paused_reason: BetaManagedAgentsDeploymentPausedReason or null`15501551    Why a deployment is paused. Non-null exactly when `status` is `paused`.15521553    - `BetaManagedAgentsManualDeploymentPausedReason object`15541555      The caller invoked the pause endpoint on the deployment.15561557      - `type: "manual"`15581559    - `BetaManagedAgentsErrorDeploymentPausedReason object`15601561      A scheduled fire recorded a failed run whose error auto-pauses the deployment.15621563      - `type: "error"`15641565      - `error: BetaManagedAgentsDeploymentPausedReasonError`15661567        The error that triggered an auto-pause. Matches the failed run's `error.type`.15681569        - `BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError object`15701571          The deployment's environment was archived.15721573          - `type: "environment_archived_error"`15741575        - `BetaManagedAgentsAgentArchivedDeploymentPausedReasonError object`15761577          The deployment's agent was archived.15781579          - `type: "agent_archived_error"`15801581        - `BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError object`15821583          The deployment's environment no longer exists.15841585          - `type: "environment_not_found_error"`15861587        - `BetaManagedAgentsVaultNotFoundDeploymentPausedReasonError object`15881589          A vault referenced by the deployment no longer exists.15901591          - `type: "vault_not_found_error"`15921593        - `BetaManagedAgentsFileNotFoundDeploymentPausedReasonError object`15941595          A file resource referenced by the deployment no longer exists.15961597          - `type: "file_not_found_error"`15981599        - `BetaManagedAgentsSessionResourceNotFoundDeploymentPausedReasonError object`16001601          A referenced resource no longer exists and its kind was not reported.16021603          - `type: "session_resource_not_found_error"`16041605        - `BetaManagedAgentsWorkspaceArchivedDeploymentPausedReasonError object`16061607          The deployment's workspace was archived.16081609          - `type: "workspace_archived_error"`16101611        - `BetaManagedAgentsOrganizationDisabledDeploymentPausedReasonError object`16121613          The deployment's organization is disabled.16141615          - `type: "organization_disabled_error"`16161617        - `BetaManagedAgentsMemoryStoreArchivedDeploymentPausedReasonError object`16181619          A memory store referenced by the deployment is archived.16201621          - `type: "memory_store_archived_error"`16221623        - `BetaManagedAgentsSkillNotFoundDeploymentPausedReasonError object`16241625          A skill referenced by the deployment's agent no longer exists.16261627          - `type: "skill_not_found_error"`16281629        - `BetaManagedAgentsVaultArchivedDeploymentPausedReasonError object`16301631          A vault referenced by the deployment is archived.16321633          - `type: "vault_archived_error"`16341635        - `BetaManagedAgentsUnknownDeploymentPausedReasonError object`16361637          An unrecognized error auto-paused the deployment. A fallback variant; matches a run whose `error.type` is `unknown_error`.16381639          - `type: "unknown_error"`16401641        - `BetaManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonError object`16421643          The deployment configures resources, but its environment is self-hosted and cannot mount them.16441645          - `type: "self_hosted_resources_unsupported_error"`16461647        - `BetaManagedAgentsMCPEgressBlockedDeploymentPausedReasonError object`16481649          An MCP server host used by the deployment's agent is blocked by the environment's network policy.16501651          - `type: "mcp_egress_blocked_error"`16521653  - `resources: array of BetaManagedAgentsSessionResourceConfig`16541655    Resources attached to sessions created from this deployment. Echoes the input minus write-only credentials.16561657    - `BetaManagedAgentsGitHubRepositoryResourceConfig object`16581659      A GitHub repository mounted into each session's container. The authorization token is write-only and never returned.16601661      - `type: "github_repository"`16621663      - `url: string`16641665        Github URL of the repository16661667      - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`16681669        Branch or commit to check out. Defaults to the repository's default branch.16701671        - `BetaManagedAgentsBranchCheckout object`16721673          - `type: "branch"`16741675          - `name: string`16761677            Branch name to check out.16781679            minLength: 1, maxLength: 25516801681        - `BetaManagedAgentsCommitCheckout object`16821683          - `type: "commit"`16841685          - `sha: string`16861687            Full commit SHA to check out.16881689            minLength: 7, maxLength: 6416901691      - `mount_path: optional string or null`16921693        Mount path in the container. Defaults to `/workspace/<repo-name>`.16941695    - `BetaManagedAgentsFileResourceConfig object`16961697      A file mounted into each session's container.16981699      - `type: "file"`17001701      - `file_id: string`17021703        ID of a previously uploaded file.17041705      - `mount_path: optional string or null`17061707        Mount path in the container. Defaults to `/mnt/session/uploads/<file_id>`.17081709    - `BetaManagedAgentsMemoryStoreResourceConfig object`17101711      A memory store attached to each session created from this deployment.17121713      - `type: "memory_store"`17141715      - `memory_store_id: string`17161717        The memory store ID (memstore_...). Must belong to the caller's organization and workspace.17181719      - `access: optional "read_write" or "read_only" or null`17201721        Access mode for an attached memory store.17221723        - `"read_write"`17241725        - `"read_only"`17261727      - `instructions: optional string or null`17281729        Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.17301731  - `schedule: BetaManagedAgentsSchedule or null`17321733    5-field POSIX cron schedule with computed runtime timestamps.17341735    - `type: "cron"`17361737    - `expression: string`17381739      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).17401741      minLength: 1, maxLength: 25617421743    - `timezone: string`17441745      IANA timezone identifier (e.g., "America/Los_Angeles", "UTC").17461747      minLength: 117481749    - `last_run_at: optional string or null`17501751      A timestamp in RFC 3339 format17521753      format: date-time17541755    - `upcoming_runs_at: optional array of string`17561757      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.17581759  - `status: BetaManagedAgentsDeploymentStatus`17601761    Lifecycle status of a deployment.17621763    - `"active"`17641765    - `"paused"`17661767  - `updated_at: string`17681769    A timestamp in RFC 3339 format17701771    format: date-time17721773  - `vault_ids: array of string`17741775    Vault IDs supplying stored credentials for sessions created from this deployment.17761777  - `budget: optional BetaManagedAgentsBudgetLimit or null`17781779    A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.17801781    - `type: "limit"`17821783    - `max_list_cost: BetaMonetaryAmount`17841785      A monetary amount in a specific currency.17861787      - `amount: string`17881789        Amount in minor units of the currency, as an integer decimal string with no leading zeros: "2500" is $25.00 and "50" is fifty cents. A string rather than a number so no float rounding is ever applied.17901791      - `currency: BetaCurrency`17921793        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.17941795- `next_page: optional string or null`17961797  Opaque cursor for the next page. Null when no more results.17981799### Example18001801```bash1802curl https://api.anthropic.com/v1/deployments \1803    -H 'anthropic-version: 2023-06-01' \1804    -H 'anthropic-beta: managed-agents-2026-04-01' \1805    -H "X-Api-Key: $ANTHROPIC_API_KEY"1806```18071808#### Response (200)18091810```json1811{1812  "data": [1813    {1814      "id": "depl_011CZkZcDH3vPqd7xnEfwTai",1815      "agent": {1816        "id": "agent_011CZkYpogX7uDKUyvBTophP",1817        "type": "agent",1818        "version": 11819      },1820      "archived_at": null,1821      "created_at": "2026-03-15T10:00:00Z",1822      "description": "Compiles yesterday's orders into a report every weekday morning.",1823      "environment_id": "env_011CZkZ9X2dpNyB7HsEFoRfW",1824      "initial_events": [1825        {1826          "content": [1827            {1828              "text": "Compile yesterday's orders into report.md.",1829              "type": "text"1830            }1831          ],1832          "type": "user.message"1833        }1834      ],1835      "metadata": {},1836      "name": "Daily order report",1837      "paused_reason": {1838        "type": "manual"1839      },1840      "resources": [1841        {1842          "type": "github_repository",1843          "url": "url",1844          "checkout": {1845            "name": "main",1846            "type": "branch"1847          },1848          "mount_path": "mount_path"1849        }1850      ],1851      "schedule": {1852        "expression": "0 9 * * 1-5",1853        "timezone": "America/Los_Angeles",1854        "type": "cron",1855        "last_run_at": "2026-03-16T16:00:09Z",1856        "upcoming_runs_at": [1857          "2026-03-17T16:00:00Z",1858          "2026-03-18T16:00:00Z"1859        ]1860      },1861      "status": "active",1862      "type": "deployment",1863      "updated_at": "2026-03-15T10:00:00Z",1864      "vault_ids": [1865        "vlt_011CZkZDLs7fYzm1hXNPeRjv"1866      ],1867      "budget": {1868        "max_list_cost": {1869          "amount": "2500",1870          "currency": "USD"1871        },1872        "type": "limit"1873      }1874    }1875  ],1876  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="1877}1878```18791880## Get Deployment18811882**GET** `/v1/deployments/{deployment_id}`18831884Get Deployment18851886### Path parameters18871888- `deployment_id: string`18891890### Headers18911892- `"anthropic-beta": optional array of AnthropicBeta`18931894  Optional header to specify the beta version(s) you want to use.18951896  - `string`18971898  - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`18991900    - `"message-batches-2024-09-24"`19011902    - `"prompt-caching-2024-07-31"`19031904    - `"computer-use-2024-10-22"`19051906    - `"computer-use-2025-01-24"`19071908    - `"pdfs-2024-09-25"`19091910    - `"token-counting-2024-11-01"`19111912    - `"token-efficient-tools-2025-02-19"`19131914    - `"output-128k-2025-02-19"`19151916    - `"files-api-2025-04-14"`19171918    - `"mcp-client-2025-04-04"`19191920    - `"mcp-client-2025-11-20"`19211922    - `"dev-full-thinking-2025-05-14"`19231924    - `"interleaved-thinking-2025-05-14"`19251926    - `"code-execution-2025-05-22"`19271928    - `"extended-cache-ttl-2025-04-11"`19291930    - `"context-1m-2025-08-07"`19311932    - `"context-management-2025-06-27"`19331934    - `"model-context-window-exceeded-2025-08-26"`19351936    - `"skills-2025-10-02"`19371938    - `"fast-mode-2026-02-01"`19391940    - `"output-300k-2026-03-24"`19411942    - `"user-profiles-2026-03-24"`19431944    - `"user-profiles-2026-08-18"`19451946    - `"user-profiles-2026-09-04"`19471948    - `"advisor-tool-2026-03-01"`19491950    - `"managed-agents-2026-04-01"`19511952    - `"cache-diagnosis-2026-04-07"`19531954    - `"dreaming-2026-04-21"`19551956    - `"thinking-token-count-2026-05-13"`19571958    - `"server-side-fallback-2026-06-01"`19591960    - `"server-side-fallback-2026-07-01"`19611962    - `"fallback-credit-2026-06-01"`19631964    - `"fallback-credit-2026-07-01"`19651966    - `"agent-memory-2026-07-22"`19671968    - `"mid-conversation-tool-changes-2026-07-01"`19691970    - `"compact-2026-01-12"`19711972    - `"computer-use-2025-11-24"`19731974    - `"mcp-tunnels-2026-06-22"`19751976    - `"structured-outputs-2025-11-13"`19771978    - `"task-budgets-2026-03-13"`19791980    - `"thinking-display-updates-2026-08-18"`19811982    - `"ce-user-management-2026-07-13"`19831984    - `"mid-conversation-output-config-2026-07-01"`19851986    - `"thinking-binding-controls-2026-08-01"`19871988    - `"mid-conversation-system-clear-at-2026-08-21"`19891990    - `"compact-2026-09-04"`19911992- `"anthropic-workspace-id": optional string`19931994### Returns19951996- `BetaManagedAgentsDeployment object`19971998  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.19992000  - `type: "deployment"`20012002  - `id: string`20032004    Unique identifier for this deployment.20052006  - `agent: BetaManagedAgentsAgentReference`20072008    A resolved agent reference with a concrete version.20092010    - `type: "agent"`20112012    - `id: string`20132014    - `version: number`20152016      format: int3220172018  - `archived_at: string or null`20192020    A timestamp in RFC 3339 format20212022    format: date-time20232024  - `created_at: string`20252026    A timestamp in RFC 3339 format20272028    format: date-time20292030  - `description: string or null`20312032    Description of what the deployment does.20332034  - `environment_id: string`20352036    ID of the `environment` where sessions run.20372038  - `initial_events: array of BetaManagedAgentsDeploymentInitialEvent`20392040    Events sent to each session immediately after creation.20412042    - `BetaManagedAgentsDeploymentUserMessageEvent object`20432044      A user message sent to the session.20452046      - `type: "user.message"`20472048      - `content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsRedactedBlock`20492050        Array of content blocks for the user message.20512052        - `BetaManagedAgentsTextBlock object`20532054          Regular text content.20552056          - `type: "text"`20572058          - `text: string`20592060            The text content.20612062            minLength: 120632064        - `BetaManagedAgentsImageBlock object`20652066          Image content specified directly as base64 data or as a reference via a URL.20672068          - `type: "image"`20692070          - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`20712072            Union type for image source variants.20732074            - `BetaManagedAgentsBase64ImageSource object`20752076              Base64-encoded image data.20772078              - `type: "base64"`20792080              - `data: string`20812082                Base64-encoded image data.20832084                minLength: 120852086              - `media_type: string`20872088                MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").20892090                minLength: 120912092            - `BetaManagedAgentsURLImageSource object`20932094              Image referenced by URL.20952096              - `type: "url"`20972098              - `url: string`20992100                URL of the image to fetch.21012102                minLength: 121032104            - `BetaManagedAgentsFileImageSource object`21052106              Image referenced by file ID.21072108              - `type: "file"`21092110              - `file_id: string`21112112                ID of a previously uploaded file.21132114                minLength: 121152116        - `BetaManagedAgentsDocumentBlock object`21172118          Document content, either specified directly as base64 data, as text, or as a reference via a URL.21192120          - `type: "document"`21212122          - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`21232124            Union type for document source variants.21252126            - `BetaManagedAgentsBase64DocumentSource object`21272128              Base64-encoded document data.21292130              - `type: "base64"`21312132              - `data: string`21332134                Base64-encoded document data.21352136                minLength: 121372138              - `media_type: string`21392140                MIME type of the document (e.g., "application/pdf").21412142                minLength: 121432144            - `BetaManagedAgentsPlainTextDocumentSource object`21452146              Plain text document content.21472148              - `type: "text"`21492150              - `data: string`21512152                The plain text content.21532154                minLength: 121552156              - `media_type: "text/plain"`21572158                MIME type of the text content. Must be "text/plain".21592160            - `BetaManagedAgentsURLDocumentSource object`21612162              Document referenced by URL.21632164              - `type: "url"`21652166              - `url: string`21672168                URL of the document to fetch.21692170                minLength: 121712172            - `BetaManagedAgentsFileDocumentSource object`21732174              Document referenced by file ID.21752176              - `type: "file"`21772178              - `file_id: string`21792180                ID of a previously uploaded file.21812182                minLength: 121832184          - `context: optional string or null`21852186            Additional context about the document for the model.21872188          - `title: optional string or null`21892190            The title of the document.21912192        - `BetaManagedAgentsRedactedBlock object`21932194          Placeholder for content withheld by Anthropic model policy.21952196          - `type: "redacted"`21972198    - `BetaManagedAgentsDeploymentUserDefineOutcomeEvent object`21992200      An outcome the agent should work toward. The agent begins work on receipt.22012202      - `type: "user.define_outcome"`22032204      - `description: string`22052206        What the agent should produce. This is the task specification.22072208      - `rubric: BetaManagedAgentsFileRubric or BetaManagedAgentsTextRubric`22092210        Rubric for grading the quality of an outcome.22112212        - `BetaManagedAgentsFileRubric object`22132214          Rubric referenced by a file uploaded via the Files API.22152216          - `type: "file"`22172218          - `file_id: string`22192220            ID of the rubric file.22212222        - `BetaManagedAgentsTextRubric object`22232224          Rubric content provided inline as text.22252226          - `type: "text"`22272228          - `content: string`22292230            Rubric content. Plain text or markdown — the grader treats it as freeform text.22312232      - `max_iterations: optional number or null`22332234        Eval→revision cycles before giving up. Default 3, max 20.22352236        format: int3222372238    - `BetaManagedAgentsDeploymentSystemMessageEvent object`22392240      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.22412242      - `type: "system.message"`22432244      - `content: array of BetaManagedAgentsSystemContentBlock`22452246        System content blocks to append. Text-only.22472248        - `type: "text"`22492250        - `text: string`22512252          The text content.22532254          minLength: 122552256  - `metadata: map[string]`22572258    Arbitrary key-value metadata. Maximum 16 pairs.22592260  - `name: string`22612262    Human-readable name.22632264  - `paused_reason: BetaManagedAgentsDeploymentPausedReason or null`22652266    Why a deployment is paused. Non-null exactly when `status` is `paused`.22672268    - `BetaManagedAgentsManualDeploymentPausedReason object`22692270      The caller invoked the pause endpoint on the deployment.22712272      - `type: "manual"`22732274    - `BetaManagedAgentsErrorDeploymentPausedReason object`22752276      A scheduled fire recorded a failed run whose error auto-pauses the deployment.22772278      - `type: "error"`22792280      - `error: BetaManagedAgentsDeploymentPausedReasonError`22812282        The error that triggered an auto-pause. Matches the failed run's `error.type`.22832284        - `BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError object`22852286          The deployment's environment was archived.22872288          - `type: "environment_archived_error"`22892290        - `BetaManagedAgentsAgentArchivedDeploymentPausedReasonError object`22912292          The deployment's agent was archived.22932294          - `type: "agent_archived_error"`22952296        - `BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError object`22972298          The deployment's environment no longer exists.22992300          - `type: "environment_not_found_error"`23012302        - `BetaManagedAgentsVaultNotFoundDeploymentPausedReasonError object`23032304          A vault referenced by the deployment no longer exists.23052306          - `type: "vault_not_found_error"`23072308        - `BetaManagedAgentsFileNotFoundDeploymentPausedReasonError object`23092310          A file resource referenced by the deployment no longer exists.23112312          - `type: "file_not_found_error"`23132314        - `BetaManagedAgentsSessionResourceNotFoundDeploymentPausedReasonError object`23152316          A referenced resource no longer exists and its kind was not reported.23172318          - `type: "session_resource_not_found_error"`23192320        - `BetaManagedAgentsWorkspaceArchivedDeploymentPausedReasonError object`23212322          The deployment's workspace was archived.23232324          - `type: "workspace_archived_error"`23252326        - `BetaManagedAgentsOrganizationDisabledDeploymentPausedReasonError object`23272328          The deployment's organization is disabled.23292330          - `type: "organization_disabled_error"`23312332        - `BetaManagedAgentsMemoryStoreArchivedDeploymentPausedReasonError object`23332334          A memory store referenced by the deployment is archived.23352336          - `type: "memory_store_archived_error"`23372338        - `BetaManagedAgentsSkillNotFoundDeploymentPausedReasonError object`23392340          A skill referenced by the deployment's agent no longer exists.23412342          - `type: "skill_not_found_error"`23432344        - `BetaManagedAgentsVaultArchivedDeploymentPausedReasonError object`23452346          A vault referenced by the deployment is archived.23472348          - `type: "vault_archived_error"`23492350        - `BetaManagedAgentsUnknownDeploymentPausedReasonError object`23512352          An unrecognized error auto-paused the deployment. A fallback variant; matches a run whose `error.type` is `unknown_error`.23532354          - `type: "unknown_error"`23552356        - `BetaManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonError object`23572358          The deployment configures resources, but its environment is self-hosted and cannot mount them.23592360          - `type: "self_hosted_resources_unsupported_error"`23612362        - `BetaManagedAgentsMCPEgressBlockedDeploymentPausedReasonError object`23632364          An MCP server host used by the deployment's agent is blocked by the environment's network policy.23652366          - `type: "mcp_egress_blocked_error"`23672368  - `resources: array of BetaManagedAgentsSessionResourceConfig`23692370    Resources attached to sessions created from this deployment. Echoes the input minus write-only credentials.23712372    - `BetaManagedAgentsGitHubRepositoryResourceConfig object`23732374      A GitHub repository mounted into each session's container. The authorization token is write-only and never returned.23752376      - `type: "github_repository"`23772378      - `url: string`23792380        Github URL of the repository23812382      - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`23832384        Branch or commit to check out. Defaults to the repository's default branch.23852386        - `BetaManagedAgentsBranchCheckout object`23872388          - `type: "branch"`23892390          - `name: string`23912392            Branch name to check out.23932394            minLength: 1, maxLength: 25523952396        - `BetaManagedAgentsCommitCheckout object`23972398          - `type: "commit"`23992400          - `sha: string`24012402            Full commit SHA to check out.24032404            minLength: 7, maxLength: 6424052406      - `mount_path: optional string or null`24072408        Mount path in the container. Defaults to `/workspace/<repo-name>`.24092410    - `BetaManagedAgentsFileResourceConfig object`24112412      A file mounted into each session's container.24132414      - `type: "file"`24152416      - `file_id: string`24172418        ID of a previously uploaded file.24192420      - `mount_path: optional string or null`24212422        Mount path in the container. Defaults to `/mnt/session/uploads/<file_id>`.24232424    - `BetaManagedAgentsMemoryStoreResourceConfig object`24252426      A memory store attached to each session created from this deployment.24272428      - `type: "memory_store"`24292430      - `memory_store_id: string`24312432        The memory store ID (memstore_...). Must belong to the caller's organization and workspace.24332434      - `access: optional "read_write" or "read_only" or null`24352436        Access mode for an attached memory store.24372438        - `"read_write"`24392440        - `"read_only"`24412442      - `instructions: optional string or null`24432444        Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.24452446  - `schedule: BetaManagedAgentsSchedule or null`24472448    5-field POSIX cron schedule with computed runtime timestamps.24492450    - `type: "cron"`24512452    - `expression: string`24532454      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).24552456      minLength: 1, maxLength: 25624572458    - `timezone: string`24592460      IANA timezone identifier (e.g., "America/Los_Angeles", "UTC").24612462      minLength: 124632464    - `last_run_at: optional string or null`24652466      A timestamp in RFC 3339 format24672468      format: date-time24692470    - `upcoming_runs_at: optional array of string`24712472      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.24732474  - `status: BetaManagedAgentsDeploymentStatus`24752476    Lifecycle status of a deployment.24772478    - `"active"`24792480    - `"paused"`24812482  - `updated_at: string`24832484    A timestamp in RFC 3339 format24852486    format: date-time24872488  - `vault_ids: array of string`24892490    Vault IDs supplying stored credentials for sessions created from this deployment.24912492  - `budget: optional BetaManagedAgentsBudgetLimit or null`24932494    A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.24952496    - `type: "limit"`24972498    - `max_list_cost: BetaMonetaryAmount`24992500      A monetary amount in a specific currency.25012502      - `amount: string`25032504        Amount in minor units of the currency, as an integer decimal string with no leading zeros: "2500" is $25.00 and "50" is fifty cents. A string rather than a number so no float rounding is ever applied.25052506      - `currency: BetaCurrency`25072508        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.25092510### Example25112512```bash2513curl https://api.anthropic.com/v1/deployments/$DEPLOYMENT_ID \2514    -H 'anthropic-version: 2023-06-01' \2515    -H 'anthropic-beta: managed-agents-2026-04-01' \2516    -H "X-Api-Key: $ANTHROPIC_API_KEY"2517```25182519#### Response (200)25202521```json2522{2523  "id": "depl_011CZkZcDH3vPqd7xnEfwTai",2524  "agent": {2525    "id": "agent_011CZkYpogX7uDKUyvBTophP",2526    "type": "agent",2527    "version": 12528  },2529  "archived_at": null,2530  "created_at": "2026-03-15T10:00:00Z",2531  "description": "Compiles yesterday's orders into a report every weekday morning.",2532  "environment_id": "env_011CZkZ9X2dpNyB7HsEFoRfW",2533  "initial_events": [2534    {2535      "content": [2536        {2537          "text": "Compile yesterday's orders into report.md.",2538          "type": "text"2539        }2540      ],2541      "type": "user.message"2542    }2543  ],2544  "metadata": {},2545  "name": "Daily order report",2546  "paused_reason": {2547    "type": "manual"2548  },2549  "resources": [2550    {2551      "type": "github_repository",2552      "url": "url",2553      "checkout": {2554        "name": "main",2555        "type": "branch"2556      },2557      "mount_path": "mount_path"2558    }2559  ],2560  "schedule": {2561    "expression": "0 9 * * 1-5",2562    "timezone": "America/Los_Angeles",2563    "type": "cron",2564    "last_run_at": "2026-03-16T16:00:09Z",2565    "upcoming_runs_at": [2566      "2026-03-17T16:00:00Z",2567      "2026-03-18T16:00:00Z"2568    ]2569  },2570  "status": "active",2571  "type": "deployment",2572  "updated_at": "2026-03-15T10:00:00Z",2573  "vault_ids": [2574    "vlt_011CZkZDLs7fYzm1hXNPeRjv"2575  ],2576  "budget": {2577    "max_list_cost": {2578      "amount": "2500",2579      "currency": "USD"2580    },2581    "type": "limit"2582  }2583}2584```25852586## Update Deployment25872588**POST** `/v1/deployments/{deployment_id}`25892590Update Deployment25912592### Path parameters25932594- `deployment_id: string`25952596### Headers25972598- `"anthropic-beta": optional array of AnthropicBeta`25992600  Optional header to specify the beta version(s) you want to use.26012602  - `string`26032604  - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`26052606    - `"message-batches-2024-09-24"`26072608    - `"prompt-caching-2024-07-31"`26092610    - `"computer-use-2024-10-22"`26112612    - `"computer-use-2025-01-24"`26132614    - `"pdfs-2024-09-25"`26152616    - `"token-counting-2024-11-01"`26172618    - `"token-efficient-tools-2025-02-19"`26192620    - `"output-128k-2025-02-19"`26212622    - `"files-api-2025-04-14"`26232624    - `"mcp-client-2025-04-04"`26252626    - `"mcp-client-2025-11-20"`26272628    - `"dev-full-thinking-2025-05-14"`26292630    - `"interleaved-thinking-2025-05-14"`26312632    - `"code-execution-2025-05-22"`26332634    - `"extended-cache-ttl-2025-04-11"`26352636    - `"context-1m-2025-08-07"`26372638    - `"context-management-2025-06-27"`26392640    - `"model-context-window-exceeded-2025-08-26"`26412642    - `"skills-2025-10-02"`26432644    - `"fast-mode-2026-02-01"`26452646    - `"output-300k-2026-03-24"`26472648    - `"user-profiles-2026-03-24"`26492650    - `"user-profiles-2026-08-18"`26512652    - `"user-profiles-2026-09-04"`26532654    - `"advisor-tool-2026-03-01"`26552656    - `"managed-agents-2026-04-01"`26572658    - `"cache-diagnosis-2026-04-07"`26592660    - `"dreaming-2026-04-21"`26612662    - `"thinking-token-count-2026-05-13"`26632664    - `"server-side-fallback-2026-06-01"`26652666    - `"server-side-fallback-2026-07-01"`26672668    - `"fallback-credit-2026-06-01"`26692670    - `"fallback-credit-2026-07-01"`26712672    - `"agent-memory-2026-07-22"`26732674    - `"mid-conversation-tool-changes-2026-07-01"`26752676    - `"compact-2026-01-12"`26772678    - `"computer-use-2025-11-24"`26792680    - `"mcp-tunnels-2026-06-22"`26812682    - `"structured-outputs-2025-11-13"`26832684    - `"task-budgets-2026-03-13"`26852686    - `"thinking-display-updates-2026-08-18"`26872688    - `"ce-user-management-2026-07-13"`26892690    - `"mid-conversation-output-config-2026-07-01"`26912692    - `"thinking-binding-controls-2026-08-01"`26932694    - `"mid-conversation-system-clear-at-2026-08-21"`26952696    - `"compact-2026-09-04"`26972698- `"anthropic-workspace-id": optional string`26992700### Body parameters27012702- `agent: optional string or BetaManagedAgentsAgentParams`27032704  Agent to deploy. Accepts the `agent` ID string, which re-pins to the latest version, or an `agent` object with both id and version specified. Omit to preserve. Cannot be cleared.27052706  - `string`27072708  - `BetaManagedAgentsAgentParams object`27092710    Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version27112712    - `type: "agent"`27132714    - `id: string`27152716      The `agent` ID.27172718      minLength: 1, maxLength: 12827192720    - `version: optional number`27212722      The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified.27232724      format: int3227252726- `budget: optional BetaManagedAgentsBudgetLimit or null`27272728  A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.27292730  - `type: "limit"`27312732  - `max_list_cost: BetaMonetaryAmount`27332734    A monetary amount in a specific currency.27352736    - `amount: string`27372738      Amount in minor units of the currency, as an integer decimal string with no leading zeros: "2500" is $25.00 and "50" is fifty cents. A string rather than a number so no float rounding is ever applied.27392740    - `currency: BetaCurrency`27412742      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.27432744- `description: optional string or null`27452746  Description. Omit to preserve; send empty string or null to clear.27472748  maxLength: 204827492750- `environment_id: optional string`27512752  ID of the `environment` where sessions run. Omit to preserve. Cannot be cleared.27532754  maxLength: 12827552756- `initial_events: optional array of BetaManagedAgentsDeploymentInitialEventParams`27572758  Initial events. Full replacement. Omit to preserve. Cannot be cleared. At least 1, maximum 50.27592760  - `BetaManagedAgentsUserMessageEventParams object`27612762    Parameters for sending a user message to the session.27632764    - `type: "user.message"`27652766    - `content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsRedactedBlock`27672768      Array of content blocks for the user message.27692770      - `BetaManagedAgentsTextBlock object`27712772        Regular text content.27732774        - `type: "text"`27752776        - `text: string`27772778          The text content.27792780          minLength: 127812782      - `BetaManagedAgentsImageBlock object`27832784        Image content specified directly as base64 data or as a reference via a URL.27852786        - `type: "image"`27872788        - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`27892790          Union type for image source variants.27912792          - `BetaManagedAgentsBase64ImageSource object`27932794            Base64-encoded image data.27952796            - `type: "base64"`27972798            - `data: string`27992800              Base64-encoded image data.28012802              minLength: 128032804            - `media_type: string`28052806              MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").28072808              minLength: 128092810          - `BetaManagedAgentsURLImageSource object`28112812            Image referenced by URL.28132814            - `type: "url"`28152816            - `url: string`28172818              URL of the image to fetch.28192820              minLength: 128212822          - `BetaManagedAgentsFileImageSource object`28232824            Image referenced by file ID.28252826            - `type: "file"`28272828            - `file_id: string`28292830              ID of a previously uploaded file.28312832              minLength: 128332834      - `BetaManagedAgentsDocumentBlock object`28352836        Document content, either specified directly as base64 data, as text, or as a reference via a URL.28372838        - `type: "document"`28392840        - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`28412842          Union type for document source variants.28432844          - `BetaManagedAgentsBase64DocumentSource object`28452846            Base64-encoded document data.28472848            - `type: "base64"`28492850            - `data: string`28512852              Base64-encoded document data.28532854              minLength: 128552856            - `media_type: string`28572858              MIME type of the document (e.g., "application/pdf").28592860              minLength: 128612862          - `BetaManagedAgentsPlainTextDocumentSource object`28632864            Plain text document content.28652866            - `type: "text"`28672868            - `data: string`28692870              The plain text content.28712872              minLength: 128732874            - `media_type: "text/plain"`28752876              MIME type of the text content. Must be "text/plain".28772878          - `BetaManagedAgentsURLDocumentSource object`28792880            Document referenced by URL.28812882            - `type: "url"`28832884            - `url: string`28852886              URL of the document to fetch.28872888              minLength: 128892890          - `BetaManagedAgentsFileDocumentSource object`28912892            Document referenced by file ID.28932894            - `type: "file"`28952896            - `file_id: string`28972898              ID of a previously uploaded file.28992900              minLength: 129012902        - `context: optional string or null`29032904          Additional context about the document for the model.29052906        - `title: optional string or null`29072908          The title of the document.29092910      - `BetaManagedAgentsRedactedBlock object`29112912        Placeholder for content withheld by Anthropic model policy.29132914        - `type: "redacted"`29152916  - `BetaManagedAgentsUserDefineOutcomeEventParams object`29172918    Parameters for defining an outcome the agent should work toward. The agent begins work on receipt.29192920    - `type: "user.define_outcome"`29212922    - `description: string`29232924      What the agent should produce. This is the task specification.29252926    - `rubric: BetaManagedAgentsFileRubricParams or BetaManagedAgentsTextRubricParams`29272928      Rubric for grading the quality of an outcome.29292930      - `BetaManagedAgentsFileRubricParams object`29312932        Rubric referenced by a file uploaded via the Files API.29332934        - `type: "file"`29352936        - `file_id: string`29372938          ID of the rubric file.29392940      - `BetaManagedAgentsTextRubricParams object`29412942        Rubric content provided inline as text.29432944        - `type: "text"`29452946        - `content: string`29472948          Rubric content. Plain text or markdown — the grader treats it as freeform text. Maximum 262144 characters.29492950          maxLength: 26214429512952    - `max_iterations: optional number or null`29532954      Eval→revision cycles before giving up. Default 3, max 20.29552956      format: int3229572958  - `BetaManagedAgentsSystemMessageEventParams object`29592960    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.29612962    - `type: "system.message"`29632964    - `content: array of BetaManagedAgentsSystemContentBlock`29652966      System content blocks to append. Text-only.29672968      - `type: "text"`29692970      - `text: string`29712972        The text content.29732974        minLength: 129752976- `metadata: optional map[string] or null`29772978  Metadata patch. Set a key to a string to upsert it, or to null to delete it. Omit the field to preserve. The stored bag is limited to 16 keys (up to 64 chars each) with values up to 512 chars.29792980- `name: optional string`29812982  Human-readable name. Must be non-empty. Omit to preserve. Cannot be cleared.29832984  maxLength: 25629852986- `resources: optional array of BetaManagedAgentsGitHubRepositoryResourceParams or BetaManagedAgentsFileResourceParams or BetaManagedAgentsMemoryStoreResourceParam or null`29872988  Session resources. Full replacement. Omit to preserve; send empty array or null to clear. Maximum 500.29892990  - `BetaManagedAgentsGitHubRepositoryResourceParams object`29912992    Mount a GitHub repository into the session's container.29932994    - `type: "github_repository"`29952996    - `url: string`29972998      Github URL of the repository29993000      minLength: 1, maxLength: 204830013002    - `authorization_token: optional string`30033004      GitHub authorization token used to clone the repository. Required for private repositories; optional for public ones.30053006      minLength: 1, maxLength: 409630073008    - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`30093010      Branch or commit to check out. Defaults to the repository's default branch.30113012      - `BetaManagedAgentsBranchCheckout object`30133014        - `type: "branch"`30153016        - `name: string`30173018          Branch name to check out.30193020          minLength: 1, maxLength: 25530213022      - `BetaManagedAgentsCommitCheckout object`30233024        - `type: "commit"`30253026        - `sha: string`30273028          Full commit SHA to check out.30293030          minLength: 7, maxLength: 6430313032    - `mount_path: optional string or null`30333034      Mount path in the container. Defaults to `/workspace/<repo-name>`.30353036      minLength: 1, maxLength: 409630373038  - `BetaManagedAgentsFileResourceParams object`30393040    Mount a file uploaded via the Files API into the session.30413042    - `type: "file"`30433044    - `file_id: string`30453046      ID of a previously uploaded file.30473048      minLength: 1, maxLength: 12830493050    - `mount_path: optional string or null`30513052      Mount path in the container. Defaults to `/mnt/session/uploads/<file_id>`.30533054      minLength: 1, maxLength: 409630553056  - `BetaManagedAgentsMemoryStoreResourceParam object`30573058    Parameters for attaching a memory store to an agent session.30593060    - `type: "memory_store"`30613062    - `memory_store_id: string`30633064      The memory store ID (memstore_...). Must belong to the caller's organization and workspace.30653066    - `access: optional "read_write" or "read_only" or null`30673068      Access mode for an attached memory store.30693070      - `"read_write"`30713072      - `"read_only"`30733074    - `instructions: optional string or null`30753076      Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.30773078      maxLength: 409630793080- `schedule: optional BetaManagedAgentsScheduleParams or null`30813082  5-field POSIX cron schedule. Literal wall-clock matching in the configured timezone.30833084  - `type: "cron"`30853086  - `expression: string`30873088    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).30893090    minLength: 1, maxLength: 25630913092  - `timezone: string`30933094    Required. IANA timezone identifier (e.g., "America/Los_Angeles", "UTC"). Validated against the IANA timezone database.30953096    minLength: 130973098- `vault_ids: optional array of string or null`30993100  Vault IDs. Full replacement. Omit to preserve; send empty array or null to clear. Maximum 50.31013102### Returns31033104- `BetaManagedAgentsDeployment object`31053106  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.31073108  - `type: "deployment"`31093110  - `id: string`31113112    Unique identifier for this deployment.31133114  - `agent: BetaManagedAgentsAgentReference`31153116    A resolved agent reference with a concrete version.31173118    - `type: "agent"`31193120    - `id: string`31213122    - `version: number`31233124      format: int3231253126  - `archived_at: string or null`31273128    A timestamp in RFC 3339 format31293130    format: date-time31313132  - `created_at: string`31333134    A timestamp in RFC 3339 format31353136    format: date-time31373138  - `description: string or null`31393140    Description of what the deployment does.31413142  - `environment_id: string`31433144    ID of the `environment` where sessions run.31453146  - `initial_events: array of BetaManagedAgentsDeploymentInitialEvent`31473148    Events sent to each session immediately after creation.31493150    - `BetaManagedAgentsDeploymentUserMessageEvent object`31513152      A user message sent to the session.31533154      - `type: "user.message"`31553156      - `content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsRedactedBlock`31573158        Array of content blocks for the user message.31593160        - `BetaManagedAgentsTextBlock object`31613162          Regular text content.31633164          - `type: "text"`31653166          - `text: string`31673168            The text content.31693170            minLength: 131713172        - `BetaManagedAgentsImageBlock object`31733174          Image content specified directly as base64 data or as a reference via a URL.31753176          - `type: "image"`31773178          - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`31793180            Union type for image source variants.31813182            - `BetaManagedAgentsBase64ImageSource object`31833184              Base64-encoded image data.31853186              - `type: "base64"`31873188              - `data: string`31893190                Base64-encoded image data.31913192                minLength: 131933194              - `media_type: string`31953196                MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").31973198                minLength: 131993200            - `BetaManagedAgentsURLImageSource object`32013202              Image referenced by URL.32033204              - `type: "url"`32053206              - `url: string`32073208                URL of the image to fetch.32093210                minLength: 132113212            - `BetaManagedAgentsFileImageSource object`32133214              Image referenced by file ID.32153216              - `type: "file"`32173218              - `file_id: string`32193220                ID of a previously uploaded file.32213222                minLength: 132233224        - `BetaManagedAgentsDocumentBlock object`32253226          Document content, either specified directly as base64 data, as text, or as a reference via a URL.32273228          - `type: "document"`32293230          - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`32313232            Union type for document source variants.32333234            - `BetaManagedAgentsBase64DocumentSource object`32353236              Base64-encoded document data.32373238              - `type: "base64"`32393240              - `data: string`32413242                Base64-encoded document data.32433244                minLength: 132453246              - `media_type: string`32473248                MIME type of the document (e.g., "application/pdf").32493250                minLength: 132513252            - `BetaManagedAgentsPlainTextDocumentSource object`32533254              Plain text document content.32553256              - `type: "text"`32573258              - `data: string`32593260                The plain text content.32613262                minLength: 132633264              - `media_type: "text/plain"`32653266                MIME type of the text content. Must be "text/plain".32673268            - `BetaManagedAgentsURLDocumentSource object`32693270              Document referenced by URL.32713272              - `type: "url"`32733274              - `url: string`32753276                URL of the document to fetch.32773278                minLength: 132793280            - `BetaManagedAgentsFileDocumentSource object`32813282              Document referenced by file ID.32833284              - `type: "file"`32853286              - `file_id: string`32873288                ID of a previously uploaded file.32893290                minLength: 132913292          - `context: optional string or null`32933294            Additional context about the document for the model.32953296          - `title: optional string or null`32973298            The title of the document.32993300        - `BetaManagedAgentsRedactedBlock object`33013302          Placeholder for content withheld by Anthropic model policy.33033304          - `type: "redacted"`33053306    - `BetaManagedAgentsDeploymentUserDefineOutcomeEvent object`33073308      An outcome the agent should work toward. The agent begins work on receipt.33093310      - `type: "user.define_outcome"`33113312      - `description: string`33133314        What the agent should produce. This is the task specification.33153316      - `rubric: BetaManagedAgentsFileRubric or BetaManagedAgentsTextRubric`33173318        Rubric for grading the quality of an outcome.33193320        - `BetaManagedAgentsFileRubric object`33213322          Rubric referenced by a file uploaded via the Files API.33233324          - `type: "file"`33253326          - `file_id: string`33273328            ID of the rubric file.33293330        - `BetaManagedAgentsTextRubric object`33313332          Rubric content provided inline as text.33333334          - `type: "text"`33353336          - `content: string`33373338            Rubric content. Plain text or markdown — the grader treats it as freeform text.33393340      - `max_iterations: optional number or null`33413342        Eval→revision cycles before giving up. Default 3, max 20.33433344        format: int3233453346    - `BetaManagedAgentsDeploymentSystemMessageEvent object`33473348      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.33493350      - `type: "system.message"`33513352      - `content: array of BetaManagedAgentsSystemContentBlock`33533354        System content blocks to append. Text-only.33553356        - `type: "text"`33573358        - `text: string`33593360          The text content.33613362          minLength: 133633364  - `metadata: map[string]`33653366    Arbitrary key-value metadata. Maximum 16 pairs.33673368  - `name: string`33693370    Human-readable name.33713372  - `paused_reason: BetaManagedAgentsDeploymentPausedReason or null`33733374    Why a deployment is paused. Non-null exactly when `status` is `paused`.33753376    - `BetaManagedAgentsManualDeploymentPausedReason object`33773378      The caller invoked the pause endpoint on the deployment.33793380      - `type: "manual"`33813382    - `BetaManagedAgentsErrorDeploymentPausedReason object`33833384      A scheduled fire recorded a failed run whose error auto-pauses the deployment.33853386      - `type: "error"`33873388      - `error: BetaManagedAgentsDeploymentPausedReasonError`33893390        The error that triggered an auto-pause. Matches the failed run's `error.type`.33913392        - `BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError object`33933394          The deployment's environment was archived.33953396          - `type: "environment_archived_error"`33973398        - `BetaManagedAgentsAgentArchivedDeploymentPausedReasonError object`33993400          The deployment's agent was archived.34013402          - `type: "agent_archived_error"`34033404        - `BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError object`34053406          The deployment's environment no longer exists.34073408          - `type: "environment_not_found_error"`34093410        - `BetaManagedAgentsVaultNotFoundDeploymentPausedReasonError object`34113412          A vault referenced by the deployment no longer exists.34133414          - `type: "vault_not_found_error"`34153416        - `BetaManagedAgentsFileNotFoundDeploymentPausedReasonError object`34173418          A file resource referenced by the deployment no longer exists.34193420          - `type: "file_not_found_error"`34213422        - `BetaManagedAgentsSessionResourceNotFoundDeploymentPausedReasonError object`34233424          A referenced resource no longer exists and its kind was not reported.34253426          - `type: "session_resource_not_found_error"`34273428        - `BetaManagedAgentsWorkspaceArchivedDeploymentPausedReasonError object`34293430          The deployment's workspace was archived.34313432          - `type: "workspace_archived_error"`34333434        - `BetaManagedAgentsOrganizationDisabledDeploymentPausedReasonError object`34353436          The deployment's organization is disabled.34373438          - `type: "organization_disabled_error"`34393440        - `BetaManagedAgentsMemoryStoreArchivedDeploymentPausedReasonError object`34413442          A memory store referenced by the deployment is archived.34433444          - `type: "memory_store_archived_error"`34453446        - `BetaManagedAgentsSkillNotFoundDeploymentPausedReasonError object`34473448          A skill referenced by the deployment's agent no longer exists.34493450          - `type: "skill_not_found_error"`34513452        - `BetaManagedAgentsVaultArchivedDeploymentPausedReasonError object`34533454          A vault referenced by the deployment is archived.34553456          - `type: "vault_archived_error"`34573458        - `BetaManagedAgentsUnknownDeploymentPausedReasonError object`34593460          An unrecognized error auto-paused the deployment. A fallback variant; matches a run whose `error.type` is `unknown_error`.34613462          - `type: "unknown_error"`34633464        - `BetaManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonError object`34653466          The deployment configures resources, but its environment is self-hosted and cannot mount them.34673468          - `type: "self_hosted_resources_unsupported_error"`34693470        - `BetaManagedAgentsMCPEgressBlockedDeploymentPausedReasonError object`34713472          An MCP server host used by the deployment's agent is blocked by the environment's network policy.34733474          - `type: "mcp_egress_blocked_error"`34753476  - `resources: array of BetaManagedAgentsSessionResourceConfig`34773478    Resources attached to sessions created from this deployment. Echoes the input minus write-only credentials.34793480    - `BetaManagedAgentsGitHubRepositoryResourceConfig object`34813482      A GitHub repository mounted into each session's container. The authorization token is write-only and never returned.34833484      - `type: "github_repository"`34853486      - `url: string`34873488        Github URL of the repository34893490      - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`34913492        Branch or commit to check out. Defaults to the repository's default branch.34933494        - `BetaManagedAgentsBranchCheckout object`34953496          - `type: "branch"`34973498          - `name: string`34993500            Branch name to check out.35013502            minLength: 1, maxLength: 25535033504        - `BetaManagedAgentsCommitCheckout object`35053506          - `type: "commit"`35073508          - `sha: string`35093510            Full commit SHA to check out.35113512            minLength: 7, maxLength: 6435133514      - `mount_path: optional string or null`35153516        Mount path in the container. Defaults to `/workspace/<repo-name>`.35173518    - `BetaManagedAgentsFileResourceConfig object`35193520      A file mounted into each session's container.35213522      - `type: "file"`35233524      - `file_id: string`35253526        ID of a previously uploaded file.35273528      - `mount_path: optional string or null`35293530        Mount path in the container. Defaults to `/mnt/session/uploads/<file_id>`.35313532    - `BetaManagedAgentsMemoryStoreResourceConfig object`35333534      A memory store attached to each session created from this deployment.35353536      - `type: "memory_store"`35373538      - `memory_store_id: string`35393540        The memory store ID (memstore_...). Must belong to the caller's organization and workspace.35413542      - `access: optional "read_write" or "read_only" or null`35433544        Access mode for an attached memory store.35453546        - `"read_write"`35473548        - `"read_only"`35493550      - `instructions: optional string or null`35513552        Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.35533554  - `schedule: BetaManagedAgentsSchedule or null`35553556    5-field POSIX cron schedule with computed runtime timestamps.35573558    - `type: "cron"`35593560    - `expression: string`35613562      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).35633564      minLength: 1, maxLength: 25635653566    - `timezone: string`35673568      IANA timezone identifier (e.g., "America/Los_Angeles", "UTC").35693570      minLength: 135713572    - `last_run_at: optional string or null`35733574      A timestamp in RFC 3339 format35753576      format: date-time35773578    - `upcoming_runs_at: optional array of string`35793580      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.35813582  - `status: BetaManagedAgentsDeploymentStatus`35833584    Lifecycle status of a deployment.35853586    - `"active"`35873588    - `"paused"`35893590  - `updated_at: string`35913592    A timestamp in RFC 3339 format35933594    format: date-time35953596  - `vault_ids: array of string`35973598    Vault IDs supplying stored credentials for sessions created from this deployment.35993600  - `budget: optional BetaManagedAgentsBudgetLimit or null`36013602    A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.36033604    - `type: "limit"`36053606    - `max_list_cost: BetaMonetaryAmount`36073608      A monetary amount in a specific currency.36093610      - `amount: string`36113612        Amount in minor units of the currency, as an integer decimal string with no leading zeros: "2500" is $25.00 and "50" is fifty cents. A string rather than a number so no float rounding is ever applied.36133614      - `currency: BetaCurrency`36153616        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.36173618### Example36193620```bash3621curl https://api.anthropic.com/v1/deployments/$DEPLOYMENT_ID \3622    -H 'Content-Type: application/json' \3623    -H 'anthropic-version: 2023-06-01' \3624    -H 'anthropic-beta: managed-agents-2026-04-01' \3625    -H "X-Api-Key: $ANTHROPIC_API_KEY" \3626    -d '{}'3627```36283629#### Response (200)36303631```json3632{3633  "id": "depl_011CZkZcDH3vPqd7xnEfwTai",3634  "agent": {3635    "id": "agent_011CZkYpogX7uDKUyvBTophP",3636    "type": "agent",3637    "version": 13638  },3639  "archived_at": null,3640  "created_at": "2026-03-15T10:00:00Z",3641  "description": "Compiles yesterday's orders into a report every weekday morning.",3642  "environment_id": "env_011CZkZ9X2dpNyB7HsEFoRfW",3643  "initial_events": [3644    {3645      "content": [3646        {3647          "text": "Compile yesterday's orders into report.md.",3648          "type": "text"3649        }3650      ],3651      "type": "user.message"3652    }3653  ],3654  "metadata": {},3655  "name": "Daily order report",3656  "paused_reason": {3657    "type": "manual"3658  },3659  "resources": [3660    {3661      "type": "github_repository",3662      "url": "url",3663      "checkout": {3664        "name": "main",3665        "type": "branch"3666      },3667      "mount_path": "mount_path"3668    }3669  ],3670  "schedule": {3671    "expression": "0 9 * * 1-5",3672    "timezone": "America/Los_Angeles",3673    "type": "cron",3674    "last_run_at": "2026-03-16T16:00:09Z",3675    "upcoming_runs_at": [3676      "2026-03-17T16:00:00Z",3677      "2026-03-18T16:00:00Z"3678    ]3679  },3680  "status": "active",3681  "type": "deployment",3682  "updated_at": "2026-03-15T10:00:00Z",3683  "vault_ids": [3684    "vlt_011CZkZDLs7fYzm1hXNPeRjv"3685  ],3686  "budget": {3687    "max_list_cost": {3688      "amount": "2500",3689      "currency": "USD"3690    },3691    "type": "limit"3692  }3693}3694```36953696## Archive Deployment36973698**POST** `/v1/deployments/{deployment_id}/archive`36993700Archive Deployment37013702### Path parameters37033704- `deployment_id: string`37053706### Headers37073708- `"anthropic-beta": optional array of AnthropicBeta`37093710  Optional header to specify the beta version(s) you want to use.37113712  - `string`37133714  - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`37153716    - `"message-batches-2024-09-24"`37173718    - `"prompt-caching-2024-07-31"`37193720    - `"computer-use-2024-10-22"`37213722    - `"computer-use-2025-01-24"`37233724    - `"pdfs-2024-09-25"`37253726    - `"token-counting-2024-11-01"`37273728    - `"token-efficient-tools-2025-02-19"`37293730    - `"output-128k-2025-02-19"`37313732    - `"files-api-2025-04-14"`37333734    - `"mcp-client-2025-04-04"`37353736    - `"mcp-client-2025-11-20"`37373738    - `"dev-full-thinking-2025-05-14"`37393740    - `"interleaved-thinking-2025-05-14"`37413742    - `"code-execution-2025-05-22"`37433744    - `"extended-cache-ttl-2025-04-11"`37453746    - `"context-1m-2025-08-07"`37473748    - `"context-management-2025-06-27"`37493750    - `"model-context-window-exceeded-2025-08-26"`37513752    - `"skills-2025-10-02"`37533754    - `"fast-mode-2026-02-01"`37553756    - `"output-300k-2026-03-24"`37573758    - `"user-profiles-2026-03-24"`37593760    - `"user-profiles-2026-08-18"`37613762    - `"user-profiles-2026-09-04"`37633764    - `"advisor-tool-2026-03-01"`37653766    - `"managed-agents-2026-04-01"`37673768    - `"cache-diagnosis-2026-04-07"`37693770    - `"dreaming-2026-04-21"`37713772    - `"thinking-token-count-2026-05-13"`37733774    - `"server-side-fallback-2026-06-01"`37753776    - `"server-side-fallback-2026-07-01"`37773778    - `"fallback-credit-2026-06-01"`37793780    - `"fallback-credit-2026-07-01"`37813782    - `"agent-memory-2026-07-22"`37833784    - `"mid-conversation-tool-changes-2026-07-01"`37853786    - `"compact-2026-01-12"`37873788    - `"computer-use-2025-11-24"`37893790    - `"mcp-tunnels-2026-06-22"`37913792    - `"structured-outputs-2025-11-13"`37933794    - `"task-budgets-2026-03-13"`37953796    - `"thinking-display-updates-2026-08-18"`37973798    - `"ce-user-management-2026-07-13"`37993800    - `"mid-conversation-output-config-2026-07-01"`38013802    - `"thinking-binding-controls-2026-08-01"`38033804    - `"mid-conversation-system-clear-at-2026-08-21"`38053806    - `"compact-2026-09-04"`38073808- `"anthropic-workspace-id": optional string`38093810### Returns38113812- `BetaManagedAgentsDeployment object`38133814  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.38153816  - `type: "deployment"`38173818  - `id: string`38193820    Unique identifier for this deployment.38213822  - `agent: BetaManagedAgentsAgentReference`38233824    A resolved agent reference with a concrete version.38253826    - `type: "agent"`38273828    - `id: string`38293830    - `version: number`38313832      format: int3238333834  - `archived_at: string or null`38353836    A timestamp in RFC 3339 format38373838    format: date-time38393840  - `created_at: string`38413842    A timestamp in RFC 3339 format38433844    format: date-time38453846  - `description: string or null`38473848    Description of what the deployment does.38493850  - `environment_id: string`38513852    ID of the `environment` where sessions run.38533854  - `initial_events: array of BetaManagedAgentsDeploymentInitialEvent`38553856    Events sent to each session immediately after creation.38573858    - `BetaManagedAgentsDeploymentUserMessageEvent object`38593860      A user message sent to the session.38613862      - `type: "user.message"`38633864      - `content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsRedactedBlock`38653866        Array of content blocks for the user message.38673868        - `BetaManagedAgentsTextBlock object`38693870          Regular text content.38713872          - `type: "text"`38733874          - `text: string`38753876            The text content.38773878            minLength: 138793880        - `BetaManagedAgentsImageBlock object`38813882          Image content specified directly as base64 data or as a reference via a URL.38833884          - `type: "image"`38853886          - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`38873888            Union type for image source variants.38893890            - `BetaManagedAgentsBase64ImageSource object`38913892              Base64-encoded image data.38933894              - `type: "base64"`38953896              - `data: string`38973898                Base64-encoded image data.38993900                minLength: 139013902              - `media_type: string`39033904                MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").39053906                minLength: 139073908            - `BetaManagedAgentsURLImageSource object`39093910              Image referenced by URL.39113912              - `type: "url"`39133914              - `url: string`39153916                URL of the image to fetch.39173918                minLength: 139193920            - `BetaManagedAgentsFileImageSource object`39213922              Image referenced by file ID.39233924              - `type: "file"`39253926              - `file_id: string`39273928                ID of a previously uploaded file.39293930                minLength: 139313932        - `BetaManagedAgentsDocumentBlock object`39333934          Document content, either specified directly as base64 data, as text, or as a reference via a URL.39353936          - `type: "document"`39373938          - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`39393940            Union type for document source variants.39413942            - `BetaManagedAgentsBase64DocumentSource object`39433944              Base64-encoded document data.39453946              - `type: "base64"`39473948              - `data: string`39493950                Base64-encoded document data.39513952                minLength: 139533954              - `media_type: string`39553956                MIME type of the document (e.g., "application/pdf").39573958                minLength: 139593960            - `BetaManagedAgentsPlainTextDocumentSource object`39613962              Plain text document content.39633964              - `type: "text"`39653966              - `data: string`39673968                The plain text content.39693970                minLength: 139713972              - `media_type: "text/plain"`39733974                MIME type of the text content. Must be "text/plain".39753976            - `BetaManagedAgentsURLDocumentSource object`39773978              Document referenced by URL.39793980              - `type: "url"`39813982              - `url: string`39833984                URL of the document to fetch.39853986                minLength: 139873988            - `BetaManagedAgentsFileDocumentSource object`39893990              Document referenced by file ID.39913992              - `type: "file"`39933994              - `file_id: string`39953996                ID of a previously uploaded file.39973998                minLength: 139994000          - `context: optional string or null`40014002            Additional context about the document for the model.40034004          - `title: optional string or null`40054006            The title of the document.40074008        - `BetaManagedAgentsRedactedBlock object`40094010          Placeholder for content withheld by Anthropic model policy.40114012          - `type: "redacted"`40134014    - `BetaManagedAgentsDeploymentUserDefineOutcomeEvent object`40154016      An outcome the agent should work toward. The agent begins work on receipt.40174018      - `type: "user.define_outcome"`40194020      - `description: string`40214022        What the agent should produce. This is the task specification.40234024      - `rubric: BetaManagedAgentsFileRubric or BetaManagedAgentsTextRubric`40254026        Rubric for grading the quality of an outcome.40274028        - `BetaManagedAgentsFileRubric object`40294030          Rubric referenced by a file uploaded via the Files API.40314032          - `type: "file"`40334034          - `file_id: string`40354036            ID of the rubric file.40374038        - `BetaManagedAgentsTextRubric object`40394040          Rubric content provided inline as text.40414042          - `type: "text"`40434044          - `content: string`40454046            Rubric content. Plain text or markdown — the grader treats it as freeform text.40474048      - `max_iterations: optional number or null`40494050        Eval→revision cycles before giving up. Default 3, max 20.40514052        format: int3240534054    - `BetaManagedAgentsDeploymentSystemMessageEvent object`40554056      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.40574058      - `type: "system.message"`40594060      - `content: array of BetaManagedAgentsSystemContentBlock`40614062        System content blocks to append. Text-only.40634064        - `type: "text"`40654066        - `text: string`40674068          The text content.40694070          minLength: 140714072  - `metadata: map[string]`40734074    Arbitrary key-value metadata. Maximum 16 pairs.40754076  - `name: string`40774078    Human-readable name.40794080  - `paused_reason: BetaManagedAgentsDeploymentPausedReason or null`40814082    Why a deployment is paused. Non-null exactly when `status` is `paused`.40834084    - `BetaManagedAgentsManualDeploymentPausedReason object`40854086      The caller invoked the pause endpoint on the deployment.40874088      - `type: "manual"`40894090    - `BetaManagedAgentsErrorDeploymentPausedReason object`40914092      A scheduled fire recorded a failed run whose error auto-pauses the deployment.40934094      - `type: "error"`40954096      - `error: BetaManagedAgentsDeploymentPausedReasonError`40974098        The error that triggered an auto-pause. Matches the failed run's `error.type`.40994100        - `BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError object`41014102          The deployment's environment was archived.41034104          - `type: "environment_archived_error"`41054106        - `BetaManagedAgentsAgentArchivedDeploymentPausedReasonError object`41074108          The deployment's agent was archived.41094110          - `type: "agent_archived_error"`41114112        - `BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError object`41134114          The deployment's environment no longer exists.41154116          - `type: "environment_not_found_error"`41174118        - `BetaManagedAgentsVaultNotFoundDeploymentPausedReasonError object`41194120          A vault referenced by the deployment no longer exists.41214122          - `type: "vault_not_found_error"`41234124        - `BetaManagedAgentsFileNotFoundDeploymentPausedReasonError object`41254126          A file resource referenced by the deployment no longer exists.41274128          - `type: "file_not_found_error"`41294130        - `BetaManagedAgentsSessionResourceNotFoundDeploymentPausedReasonError object`41314132          A referenced resource no longer exists and its kind was not reported.41334134          - `type: "session_resource_not_found_error"`41354136        - `BetaManagedAgentsWorkspaceArchivedDeploymentPausedReasonError object`41374138          The deployment's workspace was archived.41394140          - `type: "workspace_archived_error"`41414142        - `BetaManagedAgentsOrganizationDisabledDeploymentPausedReasonError object`41434144          The deployment's organization is disabled.41454146          - `type: "organization_disabled_error"`41474148        - `BetaManagedAgentsMemoryStoreArchivedDeploymentPausedReasonError object`41494150          A memory store referenced by the deployment is archived.41514152          - `type: "memory_store_archived_error"`41534154        - `BetaManagedAgentsSkillNotFoundDeploymentPausedReasonError object`41554156          A skill referenced by the deployment's agent no longer exists.41574158          - `type: "skill_not_found_error"`41594160        - `BetaManagedAgentsVaultArchivedDeploymentPausedReasonError object`41614162          A vault referenced by the deployment is archived.41634164          - `type: "vault_archived_error"`41654166        - `BetaManagedAgentsUnknownDeploymentPausedReasonError object`41674168          An unrecognized error auto-paused the deployment. A fallback variant; matches a run whose `error.type` is `unknown_error`.41694170          - `type: "unknown_error"`41714172        - `BetaManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonError object`41734174          The deployment configures resources, but its environment is self-hosted and cannot mount them.41754176          - `type: "self_hosted_resources_unsupported_error"`41774178        - `BetaManagedAgentsMCPEgressBlockedDeploymentPausedReasonError object`41794180          An MCP server host used by the deployment's agent is blocked by the environment's network policy.41814182          - `type: "mcp_egress_blocked_error"`41834184  - `resources: array of BetaManagedAgentsSessionResourceConfig`41854186    Resources attached to sessions created from this deployment. Echoes the input minus write-only credentials.41874188    - `BetaManagedAgentsGitHubRepositoryResourceConfig object`41894190      A GitHub repository mounted into each session's container. The authorization token is write-only and never returned.41914192      - `type: "github_repository"`41934194      - `url: string`41954196        Github URL of the repository41974198      - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`41994200        Branch or commit to check out. Defaults to the repository's default branch.42014202        - `BetaManagedAgentsBranchCheckout object`42034204          - `type: "branch"`42054206          - `name: string`42074208            Branch name to check out.42094210            minLength: 1, maxLength: 25542114212        - `BetaManagedAgentsCommitCheckout object`42134214          - `type: "commit"`42154216          - `sha: string`42174218            Full commit SHA to check out.42194220            minLength: 7, maxLength: 6442214222      - `mount_path: optional string or null`42234224        Mount path in the container. Defaults to `/workspace/<repo-name>`.42254226    - `BetaManagedAgentsFileResourceConfig object`42274228      A file mounted into each session's container.42294230      - `type: "file"`42314232      - `file_id: string`42334234        ID of a previously uploaded file.42354236      - `mount_path: optional string or null`42374238        Mount path in the container. Defaults to `/mnt/session/uploads/<file_id>`.42394240    - `BetaManagedAgentsMemoryStoreResourceConfig object`42414242      A memory store attached to each session created from this deployment.42434244      - `type: "memory_store"`42454246      - `memory_store_id: string`42474248        The memory store ID (memstore_...). Must belong to the caller's organization and workspace.42494250      - `access: optional "read_write" or "read_only" or null`42514252        Access mode for an attached memory store.42534254        - `"read_write"`42554256        - `"read_only"`42574258      - `instructions: optional string or null`42594260        Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.42614262  - `schedule: BetaManagedAgentsSchedule or null`42634264    5-field POSIX cron schedule with computed runtime timestamps.42654266    - `type: "cron"`42674268    - `expression: string`42694270      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).42714272      minLength: 1, maxLength: 25642734274    - `timezone: string`42754276      IANA timezone identifier (e.g., "America/Los_Angeles", "UTC").42774278      minLength: 142794280    - `last_run_at: optional string or null`42814282      A timestamp in RFC 3339 format42834284      format: date-time42854286    - `upcoming_runs_at: optional array of string`42874288      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.42894290  - `status: BetaManagedAgentsDeploymentStatus`42914292    Lifecycle status of a deployment.42934294    - `"active"`42954296    - `"paused"`42974298  - `updated_at: string`42994300    A timestamp in RFC 3339 format43014302    format: date-time43034304  - `vault_ids: array of string`43054306    Vault IDs supplying stored credentials for sessions created from this deployment.43074308  - `budget: optional BetaManagedAgentsBudgetLimit or null`43094310    A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.43114312    - `type: "limit"`43134314    - `max_list_cost: BetaMonetaryAmount`43154316      A monetary amount in a specific currency.43174318      - `amount: string`43194320        Amount in minor units of the currency, as an integer decimal string with no leading zeros: "2500" is $25.00 and "50" is fifty cents. A string rather than a number so no float rounding is ever applied.43214322      - `currency: BetaCurrency`43234324        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.43254326### Example43274328```bash4329curl https://api.anthropic.com/v1/deployments/$DEPLOYMENT_ID/archive \4330    -X POST \4331    -H 'anthropic-version: 2023-06-01' \4332    -H 'anthropic-beta: managed-agents-2026-04-01' \4333    -H "X-Api-Key: $ANTHROPIC_API_KEY"4334```43354336#### Response (200)43374338```json4339{4340  "id": "depl_011CZkZcDH3vPqd7xnEfwTai",4341  "agent": {4342    "id": "agent_011CZkYpogX7uDKUyvBTophP",4343    "type": "agent",4344    "version": 14345  },4346  "archived_at": null,4347  "created_at": "2026-03-15T10:00:00Z",4348  "description": "Compiles yesterday's orders into a report every weekday morning.",4349  "environment_id": "env_011CZkZ9X2dpNyB7HsEFoRfW",4350  "initial_events": [4351    {4352      "content": [4353        {4354          "text": "Compile yesterday's orders into report.md.",4355          "type": "text"4356        }4357      ],4358      "type": "user.message"4359    }4360  ],4361  "metadata": {},4362  "name": "Daily order report",4363  "paused_reason": {4364    "type": "manual"4365  },4366  "resources": [4367    {4368      "type": "github_repository",4369      "url": "url",4370      "checkout": {4371        "name": "main",4372        "type": "branch"4373      },4374      "mount_path": "mount_path"4375    }4376  ],4377  "schedule": {4378    "expression": "0 9 * * 1-5",4379    "timezone": "America/Los_Angeles",4380    "type": "cron",4381    "last_run_at": "2026-03-16T16:00:09Z",4382    "upcoming_runs_at": [4383      "2026-03-17T16:00:00Z",4384      "2026-03-18T16:00:00Z"4385    ]4386  },4387  "status": "active",4388  "type": "deployment",4389  "updated_at": "2026-03-15T10:00:00Z",4390  "vault_ids": [4391    "vlt_011CZkZDLs7fYzm1hXNPeRjv"4392  ],4393  "budget": {4394    "max_list_cost": {4395      "amount": "2500",4396      "currency": "USD"4397    },4398    "type": "limit"4399  }4400}4401```44024403## Run Deployment Now44044405**POST** `/v1/deployments/{deployment_id}/run`44064407Run Deployment Now44084409### Path parameters44104411- `deployment_id: string`44124413### Headers44144415- `"anthropic-beta": optional array of AnthropicBeta`44164417  Optional header to specify the beta version(s) you want to use.44184419  - `string`44204421  - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`44224423    - `"message-batches-2024-09-24"`44244425    - `"prompt-caching-2024-07-31"`44264427    - `"computer-use-2024-10-22"`44284429    - `"computer-use-2025-01-24"`44304431    - `"pdfs-2024-09-25"`44324433    - `"token-counting-2024-11-01"`44344435    - `"token-efficient-tools-2025-02-19"`44364437    - `"output-128k-2025-02-19"`44384439    - `"files-api-2025-04-14"`44404441    - `"mcp-client-2025-04-04"`44424443    - `"mcp-client-2025-11-20"`44444445    - `"dev-full-thinking-2025-05-14"`44464447    - `"interleaved-thinking-2025-05-14"`44484449    - `"code-execution-2025-05-22"`44504451    - `"extended-cache-ttl-2025-04-11"`44524453    - `"context-1m-2025-08-07"`44544455    - `"context-management-2025-06-27"`44564457    - `"model-context-window-exceeded-2025-08-26"`44584459    - `"skills-2025-10-02"`44604461    - `"fast-mode-2026-02-01"`44624463    - `"output-300k-2026-03-24"`44644465    - `"user-profiles-2026-03-24"`44664467    - `"user-profiles-2026-08-18"`44684469    - `"user-profiles-2026-09-04"`44704471    - `"advisor-tool-2026-03-01"`44724473    - `"managed-agents-2026-04-01"`44744475    - `"cache-diagnosis-2026-04-07"`44764477    - `"dreaming-2026-04-21"`44784479    - `"thinking-token-count-2026-05-13"`44804481    - `"server-side-fallback-2026-06-01"`44824483    - `"server-side-fallback-2026-07-01"`44844485    - `"fallback-credit-2026-06-01"`44864487    - `"fallback-credit-2026-07-01"`44884489    - `"agent-memory-2026-07-22"`44904491    - `"mid-conversation-tool-changes-2026-07-01"`44924493    - `"compact-2026-01-12"`44944495    - `"computer-use-2025-11-24"`44964497    - `"mcp-tunnels-2026-06-22"`44984499    - `"structured-outputs-2025-11-13"`45004501    - `"task-budgets-2026-03-13"`45024503    - `"thinking-display-updates-2026-08-18"`45044505    - `"ce-user-management-2026-07-13"`45064507    - `"mid-conversation-output-config-2026-07-01"`45084509    - `"thinking-binding-controls-2026-08-01"`45104511    - `"mid-conversation-system-clear-at-2026-08-21"`45124513    - `"compact-2026-09-04"`45144515- `"anthropic-workspace-id": optional string`45164517### Returns45184519- `BetaManagedAgentsDeploymentRun object`45204521  A persistent, append-only record of a single deployment execution. Records session creation success or failure — no session lifecycle tracking.45224523  - `type: "deployment_run"`45244525  - `id: string`45264527    Unique identifier for this run (`drun_...`).45284529  - `agent: BetaManagedAgentsAgentReference`45304531    A resolved agent reference with a concrete version.45324533    - `type: "agent"`45344535    - `id: string`45364537    - `version: number`45384539      format: int3245404541  - `created_at: string`45424543    A timestamp in RFC 3339 format45444545    format: date-time45464547  - `deployment_id: string`45484549    ID of the deployment that produced this run.45504551  - `error: BetaManagedAgentsEnvironmentArchivedRunError or BetaManagedAgentsAgentArchivedRunError or BetaManagedAgentsEnvironmentNotFoundRunError or 13 more or null`45524553    Why the run failed to create a session. The type identifies the failure; message is human-readable detail.45544555    - `BetaManagedAgentsEnvironmentArchivedRunError object`45564557      The deployment's environment was archived.45584559      - `type: "environment_archived_error"`45604561      - `message: string`45624563        Human-readable error description.45644565    - `BetaManagedAgentsAgentArchivedRunError object`45664567      The deployment's agent was archived.45684569      - `type: "agent_archived_error"`45704571      - `message: string`45724573        Human-readable error description.45744575    - `BetaManagedAgentsEnvironmentNotFoundRunError object`45764577      The deployment's environment no longer exists.45784579      - `type: "environment_not_found_error"`45804581      - `message: string`45824583        Human-readable error description.45844585    - `BetaManagedAgentsVaultNotFoundRunError object`45864587      A vault referenced by the deployment no longer exists.45884589      - `type: "vault_not_found_error"`45904591      - `message: string`45924593        Human-readable error description.45944595    - `BetaManagedAgentsVaultArchivedRunError object`45964597      A vault referenced by the deployment is archived.45984599      - `type: "vault_archived_error"`46004601      - `message: string`46024603        Human-readable error description.46044605    - `BetaManagedAgentsFileNotFoundRunError object`46064607      A file resource referenced by the deployment no longer exists.46084609      - `type: "file_not_found_error"`46104611      - `message: string`46124613        Human-readable error description.46144615    - `BetaManagedAgentsMemoryStoreArchivedRunError object`46164617      A memory store referenced by the deployment is archived.46184619      - `type: "memory_store_archived_error"`46204621      - `message: string`46224623        Human-readable error description.46244625    - `BetaManagedAgentsSkillNotFoundRunError object`46264627      A skill referenced by the deployment's agent no longer exists.46284629      - `type: "skill_not_found_error"`46304631      - `message: string`46324633        Human-readable error description.46344635    - `BetaManagedAgentsSessionResourceNotFoundRunError object`46364637      A referenced resource no longer exists and its kind was not reported.46384639      - `type: "session_resource_not_found_error"`46404641      - `message: string`46424643        Human-readable error description.46444645    - `BetaManagedAgentsWorkspaceArchivedRunError object`46464647      The deployment's workspace was archived.46484649      - `type: "workspace_archived_error"`46504651      - `message: string`46524653        Human-readable error description.46544655    - `BetaManagedAgentsOrganizationDisabledRunError object`46564657      The deployment's organization is disabled.46584659      - `type: "organization_disabled_error"`46604661      - `message: string`46624663        Human-readable error description.46644665    - `BetaManagedAgentsSessionRateLimitedRunError object`46664667      Session creation was rejected due to rate limiting. The schedule keeps firing; subsequent runs may succeed.46684669      - `type: "session_rate_limited_error"`46704671      - `message: string`46724673        Human-readable error description.46744675    - `BetaManagedAgentsSessionCreationRejectedRunError object`46764677      The session create request was rejected with a non-retryable validation error.46784679      - `type: "session_creation_rejected_error"`46804681      - `message: string`46824683        Human-readable error description.46844685    - `BetaManagedAgentsUnknownRunError object`46864687      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.46884689      - `type: "unknown_error"`46904691      - `message: string`46924693        Human-readable error description.46944695    - `BetaManagedAgentsSelfHostedResourcesUnsupportedRunError object`46964697      The deployment configures resources, but its environment is self-hosted and cannot mount them.46984699      - `type: "self_hosted_resources_unsupported_error"`47004701      - `message: string`47024703        Human-readable error description.47044705    - `BetaManagedAgentsMCPEgressBlockedRunError object`47064707      An MCP server host used by the deployment's agent is blocked by the environment's network policy.47084709      - `type: "mcp_egress_blocked_error"`47104711      - `message: string`47124713        Human-readable error description.47144715  - `session_id: string or null`47164717    Populated on success. Null on creation failure. Exactly one of `session_id` or `error` is non-null.47184719  - `trigger_context: BetaManagedAgentsTriggerContext`47204721    Describes what triggered a deployment run, with trigger-specific metadata.47224723    - `BetaManagedAgentsScheduleTriggerContext object`47244725      The run was fired by the deployment's cron schedule.47264727      - `type: "schedule"`47284729      - `scheduled_at: string`47304731        A timestamp in RFC 3339 format47324733        format: date-time47344735    - `BetaManagedAgentsManualTriggerContext object`47364737      The run was started manually by creating a session directly against the deployment.47384739      - `type: "manual"`47404741### Example47424743```bash4744curl https://api.anthropic.com/v1/deployments/$DEPLOYMENT_ID/run \4745    -X POST \4746    -H 'anthropic-version: 2023-06-01' \4747    -H 'anthropic-beta: managed-agents-2026-04-01' \4748    -H "X-Api-Key: $ANTHROPIC_API_KEY"4749```47504751#### Response (200)47524753```json4754{4755  "id": "id",4756  "agent": {4757    "id": "agent_011CZkYqphY8vELVzwCUpqiQ",4758    "type": "agent",4759    "version": 14760  },4761  "created_at": "2019-12-27T18:11:19.117Z",4762  "deployment_id": "deployment_id",4763  "error": {4764    "message": "message",4765    "type": "environment_archived_error"4766  },4767  "session_id": "session_id",4768  "trigger_context": {4769    "scheduled_at": "2019-12-27T18:11:19.117Z",4770    "type": "schedule"4771  },4772  "type": "deployment_run"4773}4774```47754776## Pause Deployment47774778**POST** `/v1/deployments/{deployment_id}/pause`47794780Pause Deployment47814782### Path parameters47834784- `deployment_id: string`47854786### Headers47874788- `"anthropic-beta": optional array of AnthropicBeta`47894790  Optional header to specify the beta version(s) you want to use.47914792  - `string`47934794  - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`47954796    - `"message-batches-2024-09-24"`47974798    - `"prompt-caching-2024-07-31"`47994800    - `"computer-use-2024-10-22"`48014802    - `"computer-use-2025-01-24"`48034804    - `"pdfs-2024-09-25"`48054806    - `"token-counting-2024-11-01"`48074808    - `"token-efficient-tools-2025-02-19"`48094810    - `"output-128k-2025-02-19"`48114812    - `"files-api-2025-04-14"`48134814    - `"mcp-client-2025-04-04"`48154816    - `"mcp-client-2025-11-20"`48174818    - `"dev-full-thinking-2025-05-14"`48194820    - `"interleaved-thinking-2025-05-14"`48214822    - `"code-execution-2025-05-22"`48234824    - `"extended-cache-ttl-2025-04-11"`48254826    - `"context-1m-2025-08-07"`48274828    - `"context-management-2025-06-27"`48294830    - `"model-context-window-exceeded-2025-08-26"`48314832    - `"skills-2025-10-02"`48334834    - `"fast-mode-2026-02-01"`48354836    - `"output-300k-2026-03-24"`48374838    - `"user-profiles-2026-03-24"`48394840    - `"user-profiles-2026-08-18"`48414842    - `"user-profiles-2026-09-04"`48434844    - `"advisor-tool-2026-03-01"`48454846    - `"managed-agents-2026-04-01"`48474848    - `"cache-diagnosis-2026-04-07"`48494850    - `"dreaming-2026-04-21"`48514852    - `"thinking-token-count-2026-05-13"`48534854    - `"server-side-fallback-2026-06-01"`48554856    - `"server-side-fallback-2026-07-01"`48574858    - `"fallback-credit-2026-06-01"`48594860    - `"fallback-credit-2026-07-01"`48614862    - `"agent-memory-2026-07-22"`48634864    - `"mid-conversation-tool-changes-2026-07-01"`48654866    - `"compact-2026-01-12"`48674868    - `"computer-use-2025-11-24"`48694870    - `"mcp-tunnels-2026-06-22"`48714872    - `"structured-outputs-2025-11-13"`48734874    - `"task-budgets-2026-03-13"`48754876    - `"thinking-display-updates-2026-08-18"`48774878    - `"ce-user-management-2026-07-13"`48794880    - `"mid-conversation-output-config-2026-07-01"`48814882    - `"thinking-binding-controls-2026-08-01"`48834884    - `"mid-conversation-system-clear-at-2026-08-21"`48854886    - `"compact-2026-09-04"`48874888- `"anthropic-workspace-id": optional string`48894890### Returns48914892- `BetaManagedAgentsDeployment object`48934894  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.48954896  - `type: "deployment"`48974898  - `id: string`48994900    Unique identifier for this deployment.49014902  - `agent: BetaManagedAgentsAgentReference`49034904    A resolved agent reference with a concrete version.49054906    - `type: "agent"`49074908    - `id: string`49094910    - `version: number`49114912      format: int3249134914  - `archived_at: string or null`49154916    A timestamp in RFC 3339 format49174918    format: date-time49194920  - `created_at: string`49214922    A timestamp in RFC 3339 format49234924    format: date-time49254926  - `description: string or null`49274928    Description of what the deployment does.49294930  - `environment_id: string`49314932    ID of the `environment` where sessions run.49334934  - `initial_events: array of BetaManagedAgentsDeploymentInitialEvent`49354936    Events sent to each session immediately after creation.49374938    - `BetaManagedAgentsDeploymentUserMessageEvent object`49394940      A user message sent to the session.49414942      - `type: "user.message"`49434944      - `content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsRedactedBlock`49454946        Array of content blocks for the user message.49474948        - `BetaManagedAgentsTextBlock object`49494950          Regular text content.49514952          - `type: "text"`49534954          - `text: string`49554956            The text content.49574958            minLength: 149594960        - `BetaManagedAgentsImageBlock object`49614962          Image content specified directly as base64 data or as a reference via a URL.49634964          - `type: "image"`49654966          - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`49674968            Union type for image source variants.49694970            - `BetaManagedAgentsBase64ImageSource object`49714972              Base64-encoded image data.49734974              - `type: "base64"`49754976              - `data: string`49774978                Base64-encoded image data.49794980                minLength: 149814982              - `media_type: string`49834984                MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").49854986                minLength: 149874988            - `BetaManagedAgentsURLImageSource object`49894990              Image referenced by URL.49914992              - `type: "url"`49934994              - `url: string`49954996                URL of the image to fetch.49974998                minLength: 149995000            - `BetaManagedAgentsFileImageSource object`50015002              Image referenced by file ID.50035004              - `type: "file"`50055006              - `file_id: string`50075008                ID of a previously uploaded file.50095010                minLength: 150115012        - `BetaManagedAgentsDocumentBlock object`50135014          Document content, either specified directly as base64 data, as text, or as a reference via a URL.50155016          - `type: "document"`50175018          - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`50195020            Union type for document source variants.50215022            - `BetaManagedAgentsBase64DocumentSource object`50235024              Base64-encoded document data.50255026              - `type: "base64"`50275028              - `data: string`50295030                Base64-encoded document data.50315032                minLength: 150335034              - `media_type: string`50355036                MIME type of the document (e.g., "application/pdf").50375038                minLength: 150395040            - `BetaManagedAgentsPlainTextDocumentSource object`50415042              Plain text document content.50435044              - `type: "text"`50455046              - `data: string`50475048                The plain text content.50495050                minLength: 150515052              - `media_type: "text/plain"`50535054                MIME type of the text content. Must be "text/plain".50555056            - `BetaManagedAgentsURLDocumentSource object`50575058              Document referenced by URL.50595060              - `type: "url"`50615062              - `url: string`50635064                URL of the document to fetch.50655066                minLength: 150675068            - `BetaManagedAgentsFileDocumentSource object`50695070              Document referenced by file ID.50715072              - `type: "file"`50735074              - `file_id: string`50755076                ID of a previously uploaded file.50775078                minLength: 150795080          - `context: optional string or null`50815082            Additional context about the document for the model.50835084          - `title: optional string or null`50855086            The title of the document.50875088        - `BetaManagedAgentsRedactedBlock object`50895090          Placeholder for content withheld by Anthropic model policy.50915092          - `type: "redacted"`50935094    - `BetaManagedAgentsDeploymentUserDefineOutcomeEvent object`50955096      An outcome the agent should work toward. The agent begins work on receipt.50975098      - `type: "user.define_outcome"`50995100      - `description: string`51015102        What the agent should produce. This is the task specification.51035104      - `rubric: BetaManagedAgentsFileRubric or BetaManagedAgentsTextRubric`51055106        Rubric for grading the quality of an outcome.51075108        - `BetaManagedAgentsFileRubric object`51095110          Rubric referenced by a file uploaded via the Files API.51115112          - `type: "file"`51135114          - `file_id: string`51155116            ID of the rubric file.51175118        - `BetaManagedAgentsTextRubric object`51195120          Rubric content provided inline as text.51215122          - `type: "text"`51235124          - `content: string`51255126            Rubric content. Plain text or markdown — the grader treats it as freeform text.51275128      - `max_iterations: optional number or null`51295130        Eval→revision cycles before giving up. Default 3, max 20.51315132        format: int3251335134    - `BetaManagedAgentsDeploymentSystemMessageEvent object`51355136      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.51375138      - `type: "system.message"`51395140      - `content: array of BetaManagedAgentsSystemContentBlock`51415142        System content blocks to append. Text-only.51435144        - `type: "text"`51455146        - `text: string`51475148          The text content.51495150          minLength: 151515152  - `metadata: map[string]`51535154    Arbitrary key-value metadata. Maximum 16 pairs.51555156  - `name: string`51575158    Human-readable name.51595160  - `paused_reason: BetaManagedAgentsDeploymentPausedReason or null`51615162    Why a deployment is paused. Non-null exactly when `status` is `paused`.51635164    - `BetaManagedAgentsManualDeploymentPausedReason object`51655166      The caller invoked the pause endpoint on the deployment.51675168      - `type: "manual"`51695170    - `BetaManagedAgentsErrorDeploymentPausedReason object`51715172      A scheduled fire recorded a failed run whose error auto-pauses the deployment.51735174      - `type: "error"`51755176      - `error: BetaManagedAgentsDeploymentPausedReasonError`51775178        The error that triggered an auto-pause. Matches the failed run's `error.type`.51795180        - `BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError object`51815182          The deployment's environment was archived.51835184          - `type: "environment_archived_error"`51855186        - `BetaManagedAgentsAgentArchivedDeploymentPausedReasonError object`51875188          The deployment's agent was archived.51895190          - `type: "agent_archived_error"`51915192        - `BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError object`51935194          The deployment's environment no longer exists.51955196          - `type: "environment_not_found_error"`51975198        - `BetaManagedAgentsVaultNotFoundDeploymentPausedReasonError object`51995200          A vault referenced by the deployment no longer exists.52015202          - `type: "vault_not_found_error"`52035204        - `BetaManagedAgentsFileNotFoundDeploymentPausedReasonError object`52055206          A file resource referenced by the deployment no longer exists.52075208          - `type: "file_not_found_error"`52095210        - `BetaManagedAgentsSessionResourceNotFoundDeploymentPausedReasonError object`52115212          A referenced resource no longer exists and its kind was not reported.52135214          - `type: "session_resource_not_found_error"`52155216        - `BetaManagedAgentsWorkspaceArchivedDeploymentPausedReasonError object`52175218          The deployment's workspace was archived.52195220          - `type: "workspace_archived_error"`52215222        - `BetaManagedAgentsOrganizationDisabledDeploymentPausedReasonError object`52235224          The deployment's organization is disabled.52255226          - `type: "organization_disabled_error"`52275228        - `BetaManagedAgentsMemoryStoreArchivedDeploymentPausedReasonError object`52295230          A memory store referenced by the deployment is archived.52315232          - `type: "memory_store_archived_error"`52335234        - `BetaManagedAgentsSkillNotFoundDeploymentPausedReasonError object`52355236          A skill referenced by the deployment's agent no longer exists.52375238          - `type: "skill_not_found_error"`52395240        - `BetaManagedAgentsVaultArchivedDeploymentPausedReasonError object`52415242          A vault referenced by the deployment is archived.52435244          - `type: "vault_archived_error"`52455246        - `BetaManagedAgentsUnknownDeploymentPausedReasonError object`52475248          An unrecognized error auto-paused the deployment. A fallback variant; matches a run whose `error.type` is `unknown_error`.52495250          - `type: "unknown_error"`52515252        - `BetaManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonError object`52535254          The deployment configures resources, but its environment is self-hosted and cannot mount them.52555256          - `type: "self_hosted_resources_unsupported_error"`52575258        - `BetaManagedAgentsMCPEgressBlockedDeploymentPausedReasonError object`52595260          An MCP server host used by the deployment's agent is blocked by the environment's network policy.52615262          - `type: "mcp_egress_blocked_error"`52635264  - `resources: array of BetaManagedAgentsSessionResourceConfig`52655266    Resources attached to sessions created from this deployment. Echoes the input minus write-only credentials.52675268    - `BetaManagedAgentsGitHubRepositoryResourceConfig object`52695270      A GitHub repository mounted into each session's container. The authorization token is write-only and never returned.52715272      - `type: "github_repository"`52735274      - `url: string`52755276        Github URL of the repository52775278      - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`52795280        Branch or commit to check out. Defaults to the repository's default branch.52815282        - `BetaManagedAgentsBranchCheckout object`52835284          - `type: "branch"`52855286          - `name: string`52875288            Branch name to check out.52895290            minLength: 1, maxLength: 25552915292        - `BetaManagedAgentsCommitCheckout object`52935294          - `type: "commit"`52955296          - `sha: string`52975298            Full commit SHA to check out.52995300            minLength: 7, maxLength: 6453015302      - `mount_path: optional string or null`53035304        Mount path in the container. Defaults to `/workspace/<repo-name>`.53055306    - `BetaManagedAgentsFileResourceConfig object`53075308      A file mounted into each session's container.53095310      - `type: "file"`53115312      - `file_id: string`53135314        ID of a previously uploaded file.53155316      - `mount_path: optional string or null`53175318        Mount path in the container. Defaults to `/mnt/session/uploads/<file_id>`.53195320    - `BetaManagedAgentsMemoryStoreResourceConfig object`53215322      A memory store attached to each session created from this deployment.53235324      - `type: "memory_store"`53255326      - `memory_store_id: string`53275328        The memory store ID (memstore_...). Must belong to the caller's organization and workspace.53295330      - `access: optional "read_write" or "read_only" or null`53315332        Access mode for an attached memory store.53335334        - `"read_write"`53355336        - `"read_only"`53375338      - `instructions: optional string or null`53395340        Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.53415342  - `schedule: BetaManagedAgentsSchedule or null`53435344    5-field POSIX cron schedule with computed runtime timestamps.53455346    - `type: "cron"`53475348    - `expression: string`53495350      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).53515352      minLength: 1, maxLength: 25653535354    - `timezone: string`53555356      IANA timezone identifier (e.g., "America/Los_Angeles", "UTC").53575358      minLength: 153595360    - `last_run_at: optional string or null`53615362      A timestamp in RFC 3339 format53635364      format: date-time53655366    - `upcoming_runs_at: optional array of string`53675368      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.53695370  - `status: BetaManagedAgentsDeploymentStatus`53715372    Lifecycle status of a deployment.53735374    - `"active"`53755376    - `"paused"`53775378  - `updated_at: string`53795380    A timestamp in RFC 3339 format53815382    format: date-time53835384  - `vault_ids: array of string`53855386    Vault IDs supplying stored credentials for sessions created from this deployment.53875388  - `budget: optional BetaManagedAgentsBudgetLimit or null`53895390    A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.53915392    - `type: "limit"`53935394    - `max_list_cost: BetaMonetaryAmount`53955396      A monetary amount in a specific currency.53975398      - `amount: string`53995400        Amount in minor units of the currency, as an integer decimal string with no leading zeros: "2500" is $25.00 and "50" is fifty cents. A string rather than a number so no float rounding is ever applied.54015402      - `currency: BetaCurrency`54035404        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.54055406### Example54075408```bash5409curl https://api.anthropic.com/v1/deployments/$DEPLOYMENT_ID/pause \5410    -X POST \5411    -H 'anthropic-version: 2023-06-01' \5412    -H 'anthropic-beta: managed-agents-2026-04-01' \5413    -H "X-Api-Key: $ANTHROPIC_API_KEY"5414```54155416#### Response (200)54175418```json5419{5420  "id": "depl_011CZkZcDH3vPqd7xnEfwTai",5421  "agent": {5422    "id": "agent_011CZkYpogX7uDKUyvBTophP",5423    "type": "agent",5424    "version": 15425  },5426  "archived_at": null,5427  "created_at": "2026-03-15T10:00:00Z",5428  "description": "Compiles yesterday's orders into a report every weekday morning.",5429  "environment_id": "env_011CZkZ9X2dpNyB7HsEFoRfW",5430  "initial_events": [5431    {5432      "content": [5433        {5434          "text": "Compile yesterday's orders into report.md.",5435          "type": "text"5436        }5437      ],5438      "type": "user.message"5439    }5440  ],5441  "metadata": {},5442  "name": "Daily order report",5443  "paused_reason": {5444    "type": "manual"5445  },5446  "resources": [5447    {5448      "type": "github_repository",5449      "url": "url",5450      "checkout": {5451        "name": "main",5452        "type": "branch"5453      },5454      "mount_path": "mount_path"5455    }5456  ],5457  "schedule": {5458    "expression": "0 9 * * 1-5",5459    "timezone": "America/Los_Angeles",5460    "type": "cron",5461    "last_run_at": "2026-03-16T16:00:09Z",5462    "upcoming_runs_at": [5463      "2026-03-17T16:00:00Z",5464      "2026-03-18T16:00:00Z"5465    ]5466  },5467  "status": "active",5468  "type": "deployment",5469  "updated_at": "2026-03-15T10:00:00Z",5470  "vault_ids": [5471    "vlt_011CZkZDLs7fYzm1hXNPeRjv"5472  ],5473  "budget": {5474    "max_list_cost": {5475      "amount": "2500",5476      "currency": "USD"5477    },5478    "type": "limit"5479  }5480}5481```54825483## Unpause Deployment54845485**POST** `/v1/deployments/{deployment_id}/unpause`54865487Unpause Deployment54885489### Path parameters54905491- `deployment_id: string`54925493### Headers54945495- `"anthropic-beta": optional array of AnthropicBeta`54965497  Optional header to specify the beta version(s) you want to use.54985499  - `string`55005501  - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`55025503    - `"message-batches-2024-09-24"`55045505    - `"prompt-caching-2024-07-31"`55065507    - `"computer-use-2024-10-22"`55085509    - `"computer-use-2025-01-24"`55105511    - `"pdfs-2024-09-25"`55125513    - `"token-counting-2024-11-01"`55145515    - `"token-efficient-tools-2025-02-19"`55165517    - `"output-128k-2025-02-19"`55185519    - `"files-api-2025-04-14"`55205521    - `"mcp-client-2025-04-04"`55225523    - `"mcp-client-2025-11-20"`55245525    - `"dev-full-thinking-2025-05-14"`55265527    - `"interleaved-thinking-2025-05-14"`55285529    - `"code-execution-2025-05-22"`55305531    - `"extended-cache-ttl-2025-04-11"`55325533    - `"context-1m-2025-08-07"`55345535    - `"context-management-2025-06-27"`55365537    - `"model-context-window-exceeded-2025-08-26"`55385539    - `"skills-2025-10-02"`55405541    - `"fast-mode-2026-02-01"`55425543    - `"output-300k-2026-03-24"`55445545    - `"user-profiles-2026-03-24"`55465547    - `"user-profiles-2026-08-18"`55485549    - `"user-profiles-2026-09-04"`55505551    - `"advisor-tool-2026-03-01"`55525553    - `"managed-agents-2026-04-01"`55545555    - `"cache-diagnosis-2026-04-07"`55565557    - `"dreaming-2026-04-21"`55585559    - `"thinking-token-count-2026-05-13"`55605561    - `"server-side-fallback-2026-06-01"`55625563    - `"server-side-fallback-2026-07-01"`55645565    - `"fallback-credit-2026-06-01"`55665567    - `"fallback-credit-2026-07-01"`55685569    - `"agent-memory-2026-07-22"`55705571    - `"mid-conversation-tool-changes-2026-07-01"`55725573    - `"compact-2026-01-12"`55745575    - `"computer-use-2025-11-24"`55765577    - `"mcp-tunnels-2026-06-22"`55785579    - `"structured-outputs-2025-11-13"`55805581    - `"task-budgets-2026-03-13"`55825583    - `"thinking-display-updates-2026-08-18"`55845585    - `"ce-user-management-2026-07-13"`55865587    - `"mid-conversation-output-config-2026-07-01"`55885589    - `"thinking-binding-controls-2026-08-01"`55905591    - `"mid-conversation-system-clear-at-2026-08-21"`55925593    - `"compact-2026-09-04"`55945595- `"anthropic-workspace-id": optional string`55965597### Returns55985599- `BetaManagedAgentsDeployment object`56005601  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.56025603  - `type: "deployment"`56045605  - `id: string`56065607    Unique identifier for this deployment.56085609  - `agent: BetaManagedAgentsAgentReference`56105611    A resolved agent reference with a concrete version.56125613    - `type: "agent"`56145615    - `id: string`56165617    - `version: number`56185619      format: int3256205621  - `archived_at: string or null`56225623    A timestamp in RFC 3339 format56245625    format: date-time56265627  - `created_at: string`56285629    A timestamp in RFC 3339 format56305631    format: date-time56325633  - `description: string or null`56345635    Description of what the deployment does.56365637  - `environment_id: string`56385639    ID of the `environment` where sessions run.56405641  - `initial_events: array of BetaManagedAgentsDeploymentInitialEvent`56425643    Events sent to each session immediately after creation.56445645    - `BetaManagedAgentsDeploymentUserMessageEvent object`56465647      A user message sent to the session.56485649      - `type: "user.message"`56505651      - `content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsRedactedBlock`56525653        Array of content blocks for the user message.56545655        - `BetaManagedAgentsTextBlock object`56565657          Regular text content.56585659          - `type: "text"`56605661          - `text: string`56625663            The text content.56645665            minLength: 156665667        - `BetaManagedAgentsImageBlock object`56685669          Image content specified directly as base64 data or as a reference via a URL.56705671          - `type: "image"`56725673          - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`56745675            Union type for image source variants.56765677            - `BetaManagedAgentsBase64ImageSource object`56785679              Base64-encoded image data.56805681              - `type: "base64"`56825683              - `data: string`56845685                Base64-encoded image data.56865687                minLength: 156885689              - `media_type: string`56905691                MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").56925693                minLength: 156945695            - `BetaManagedAgentsURLImageSource object`56965697              Image referenced by URL.56985699              - `type: "url"`57005701              - `url: string`57025703                URL of the image to fetch.57045705                minLength: 157065707            - `BetaManagedAgentsFileImageSource object`57085709              Image referenced by file ID.57105711              - `type: "file"`57125713              - `file_id: string`57145715                ID of a previously uploaded file.57165717                minLength: 157185719        - `BetaManagedAgentsDocumentBlock object`57205721          Document content, either specified directly as base64 data, as text, or as a reference via a URL.57225723          - `type: "document"`57245725          - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`57265727            Union type for document source variants.57285729            - `BetaManagedAgentsBase64DocumentSource object`57305731              Base64-encoded document data.57325733              - `type: "base64"`57345735              - `data: string`57365737                Base64-encoded document data.57385739                minLength: 157405741              - `media_type: string`57425743                MIME type of the document (e.g., "application/pdf").57445745                minLength: 157465747            - `BetaManagedAgentsPlainTextDocumentSource object`57485749              Plain text document content.57505751              - `type: "text"`57525753              - `data: string`57545755                The plain text content.57565757                minLength: 157585759              - `media_type: "text/plain"`57605761                MIME type of the text content. Must be "text/plain".57625763            - `BetaManagedAgentsURLDocumentSource object`57645765              Document referenced by URL.57665767              - `type: "url"`57685769              - `url: string`57705771                URL of the document to fetch.57725773                minLength: 157745775            - `BetaManagedAgentsFileDocumentSource object`57765777              Document referenced by file ID.57785779              - `type: "file"`57805781              - `file_id: string`57825783                ID of a previously uploaded file.57845785                minLength: 157865787          - `context: optional string or null`57885789            Additional context about the document for the model.57905791          - `title: optional string or null`57925793            The title of the document.57945795        - `BetaManagedAgentsRedactedBlock object`57965797          Placeholder for content withheld by Anthropic model policy.57985799          - `type: "redacted"`58005801    - `BetaManagedAgentsDeploymentUserDefineOutcomeEvent object`58025803      An outcome the agent should work toward. The agent begins work on receipt.58045805      - `type: "user.define_outcome"`58065807      - `description: string`58085809        What the agent should produce. This is the task specification.58105811      - `rubric: BetaManagedAgentsFileRubric or BetaManagedAgentsTextRubric`58125813        Rubric for grading the quality of an outcome.58145815        - `BetaManagedAgentsFileRubric object`58165817          Rubric referenced by a file uploaded via the Files API.58185819          - `type: "file"`58205821          - `file_id: string`58225823            ID of the rubric file.58245825        - `BetaManagedAgentsTextRubric object`58265827          Rubric content provided inline as text.58285829          - `type: "text"`58305831          - `content: string`58325833            Rubric content. Plain text or markdown — the grader treats it as freeform text.58345835      - `max_iterations: optional number or null`58365837        Eval→revision cycles before giving up. Default 3, max 20.58385839        format: int3258405841    - `BetaManagedAgentsDeploymentSystemMessageEvent object`58425843      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.58445845      - `type: "system.message"`58465847      - `content: array of BetaManagedAgentsSystemContentBlock`58485849        System content blocks to append. Text-only.58505851        - `type: "text"`58525853        - `text: string`58545855          The text content.58565857          minLength: 158585859  - `metadata: map[string]`58605861    Arbitrary key-value metadata. Maximum 16 pairs.58625863  - `name: string`58645865    Human-readable name.58665867  - `paused_reason: BetaManagedAgentsDeploymentPausedReason or null`58685869    Why a deployment is paused. Non-null exactly when `status` is `paused`.58705871    - `BetaManagedAgentsManualDeploymentPausedReason object`58725873      The caller invoked the pause endpoint on the deployment.58745875      - `type: "manual"`58765877    - `BetaManagedAgentsErrorDeploymentPausedReason object`58785879      A scheduled fire recorded a failed run whose error auto-pauses the deployment.58805881      - `type: "error"`58825883      - `error: BetaManagedAgentsDeploymentPausedReasonError`58845885        The error that triggered an auto-pause. Matches the failed run's `error.type`.58865887        - `BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError object`58885889          The deployment's environment was archived.58905891          - `type: "environment_archived_error"`58925893        - `BetaManagedAgentsAgentArchivedDeploymentPausedReasonError object`58945895          The deployment's agent was archived.58965897          - `type: "agent_archived_error"`58985899        - `BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError object`59005901          The deployment's environment no longer exists.59025903          - `type: "environment_not_found_error"`59045905        - `BetaManagedAgentsVaultNotFoundDeploymentPausedReasonError object`59065907          A vault referenced by the deployment no longer exists.59085909          - `type: "vault_not_found_error"`59105911        - `BetaManagedAgentsFileNotFoundDeploymentPausedReasonError object`59125913          A file resource referenced by the deployment no longer exists.59145915          - `type: "file_not_found_error"`59165917        - `BetaManagedAgentsSessionResourceNotFoundDeploymentPausedReasonError object`59185919          A referenced resource no longer exists and its kind was not reported.59205921          - `type: "session_resource_not_found_error"`59225923        - `BetaManagedAgentsWorkspaceArchivedDeploymentPausedReasonError object`59245925          The deployment's workspace was archived.59265927          - `type: "workspace_archived_error"`59285929        - `BetaManagedAgentsOrganizationDisabledDeploymentPausedReasonError object`59305931          The deployment's organization is disabled.59325933          - `type: "organization_disabled_error"`59345935        - `BetaManagedAgentsMemoryStoreArchivedDeploymentPausedReasonError object`59365937          A memory store referenced by the deployment is archived.59385939          - `type: "memory_store_archived_error"`59405941        - `BetaManagedAgentsSkillNotFoundDeploymentPausedReasonError object`59425943          A skill referenced by the deployment's agent no longer exists.59445945          - `type: "skill_not_found_error"`59465947        - `BetaManagedAgentsVaultArchivedDeploymentPausedReasonError object`59485949          A vault referenced by the deployment is archived.59505951          - `type: "vault_archived_error"`59525953        - `BetaManagedAgentsUnknownDeploymentPausedReasonError object`59545955          An unrecognized error auto-paused the deployment. A fallback variant; matches a run whose `error.type` is `unknown_error`.59565957          - `type: "unknown_error"`59585959        - `BetaManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonError object`59605961          The deployment configures resources, but its environment is self-hosted and cannot mount them.59625963          - `type: "self_hosted_resources_unsupported_error"`59645965        - `BetaManagedAgentsMCPEgressBlockedDeploymentPausedReasonError object`59665967          An MCP server host used by the deployment's agent is blocked by the environment's network policy.59685969          - `type: "mcp_egress_blocked_error"`59705971  - `resources: array of BetaManagedAgentsSessionResourceConfig`59725973    Resources attached to sessions created from this deployment. Echoes the input minus write-only credentials.59745975    - `BetaManagedAgentsGitHubRepositoryResourceConfig object`59765977      A GitHub repository mounted into each session's container. The authorization token is write-only and never returned.59785979      - `type: "github_repository"`59805981      - `url: string`59825983        Github URL of the repository59845985      - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`59865987        Branch or commit to check out. Defaults to the repository's default branch.59885989        - `BetaManagedAgentsBranchCheckout object`59905991          - `type: "branch"`59925993          - `name: string`59945995            Branch name to check out.59965997            minLength: 1, maxLength: 25559985999        - `BetaManagedAgentsCommitCheckout object`60006001          - `type: "commit"`60026003          - `sha: string`60046005            Full commit SHA to check out.60066007            minLength: 7, maxLength: 6460086009      - `mount_path: optional string or null`60106011        Mount path in the container. Defaults to `/workspace/<repo-name>`.60126013    - `BetaManagedAgentsFileResourceConfig object`60146015      A file mounted into each session's container.60166017      - `type: "file"`60186019      - `file_id: string`60206021        ID of a previously uploaded file.60226023      - `mount_path: optional string or null`60246025        Mount path in the container. Defaults to `/mnt/session/uploads/<file_id>`.60266027    - `BetaManagedAgentsMemoryStoreResourceConfig object`60286029      A memory store attached to each session created from this deployment.60306031      - `type: "memory_store"`60326033      - `memory_store_id: string`60346035        The memory store ID (memstore_...). Must belong to the caller's organization and workspace.60366037      - `access: optional "read_write" or "read_only" or null`60386039        Access mode for an attached memory store.60406041        - `"read_write"`60426043        - `"read_only"`60446045      - `instructions: optional string or null`60466047        Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.60486049  - `schedule: BetaManagedAgentsSchedule or null`60506051    5-field POSIX cron schedule with computed runtime timestamps.60526053    - `type: "cron"`60546055    - `expression: string`60566057      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).60586059      minLength: 1, maxLength: 25660606061    - `timezone: string`60626063      IANA timezone identifier (e.g., "America/Los_Angeles", "UTC").60646065      minLength: 160666067    - `last_run_at: optional string or null`60686069      A timestamp in RFC 3339 format60706071      format: date-time60726073    - `upcoming_runs_at: optional array of string`60746075      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.60766077  - `status: BetaManagedAgentsDeploymentStatus`60786079    Lifecycle status of a deployment.60806081    - `"active"`60826083    - `"paused"`60846085  - `updated_at: string`60866087    A timestamp in RFC 3339 format60886089    format: date-time60906091  - `vault_ids: array of string`60926093    Vault IDs supplying stored credentials for sessions created from this deployment.60946095  - `budget: optional BetaManagedAgentsBudgetLimit or null`60966097    A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.60986099    - `type: "limit"`61006101    - `max_list_cost: BetaMonetaryAmount`61026103      A monetary amount in a specific currency.61046105      - `amount: string`61066107        Amount in minor units of the currency, as an integer decimal string with no leading zeros: "2500" is $25.00 and "50" is fifty cents. A string rather than a number so no float rounding is ever applied.61086109      - `currency: BetaCurrency`61106111        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.61126113### Example61146115```bash6116curl https://api.anthropic.com/v1/deployments/$DEPLOYMENT_ID/unpause \6117    -X POST \6118    -H 'anthropic-version: 2023-06-01' \6119    -H 'anthropic-beta: managed-agents-2026-04-01' \6120    -H "X-Api-Key: $ANTHROPIC_API_KEY"6121```61226123#### Response (200)61246125```json6126{6127  "id": "depl_011CZkZcDH3vPqd7xnEfwTai",6128  "agent": {6129    "id": "agent_011CZkYpogX7uDKUyvBTophP",6130    "type": "agent",6131    "version": 16132  },6133  "archived_at": null,6134  "created_at": "2026-03-15T10:00:00Z",6135  "description": "Compiles yesterday's orders into a report every weekday morning.",6136  "environment_id": "env_011CZkZ9X2dpNyB7HsEFoRfW",6137  "initial_events": [6138    {6139      "content": [6140        {6141          "text": "Compile yesterday's orders into report.md.",6142          "type": "text"6143        }6144      ],6145      "type": "user.message"6146    }6147  ],6148  "metadata": {},6149  "name": "Daily order report",6150  "paused_reason": {6151    "type": "manual"6152  },6153  "resources": [6154    {6155      "type": "github_repository",6156      "url": "url",6157      "checkout": {6158        "name": "main",6159        "type": "branch"6160      },6161      "mount_path": "mount_path"6162    }6163  ],6164  "schedule": {6165    "expression": "0 9 * * 1-5",6166    "timezone": "America/Los_Angeles",6167    "type": "cron",6168    "last_run_at": "2026-03-16T16:00:09Z",6169    "upcoming_runs_at": [6170      "2026-03-17T16:00:00Z",6171      "2026-03-18T16:00:00Z"6172    ]6173  },6174  "status": "active",6175  "type": "deployment",6176  "updated_at": "2026-03-15T10:00:00Z",6177  "vault_ids": [6178    "vlt_011CZkZDLs7fYzm1hXNPeRjv"6179  ],6180  "budget": {6181    "max_list_cost": {6182      "amount": "2500",6183      "currency": "USD"6184    },6185    "type": "limit"6186  }6187}6188```61896190## Domain types61916192### Beta Managed Agents Agent Archived Deployment Paused Reason Error61936194- `BetaManagedAgentsAgentArchivedDeploymentPausedReasonError object`61956196  The deployment's agent was archived.61976198  - `type: "agent_archived_error"`61996200### Beta Managed Agents Cron Schedule62016202- `BetaManagedAgentsCronSchedule object`62036204  5-field POSIX cron schedule with computed runtime timestamps.62056206  - `type: "cron"`62076208  - `expression: string`62096210    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).62116212    minLength: 1, maxLength: 25662136214  - `timezone: string`62156216    IANA timezone identifier (e.g., "America/Los_Angeles", "UTC").62176218    minLength: 162196220  - `last_run_at: optional string or null`62216222    A timestamp in RFC 3339 format62236224    format: date-time62256226  - `upcoming_runs_at: optional array of string`62276228    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.62296230### Beta Managed Agents Cron Schedule Params62316232- `BetaManagedAgentsCronScheduleParams object`62336234  5-field POSIX cron schedule. Literal wall-clock matching in the configured timezone.62356236  - `type: "cron"`62376238  - `expression: string`62396240    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).62416242    minLength: 1, maxLength: 25662436244  - `timezone: string`62456246    Required. IANA timezone identifier (e.g., "America/Los_Angeles", "UTC"). Validated against the IANA timezone database.62476248    minLength: 162496250### Beta Managed Agents Deployment62516252- `BetaManagedAgentsDeployment object`62536254  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.62556256  - `type: "deployment"`62576258  - `id: string`62596260    Unique identifier for this deployment.62616262  - `agent: BetaManagedAgentsAgentReference`62636264    A resolved agent reference with a concrete version.62656266    - `type: "agent"`62676268    - `id: string`62696270    - `version: number`62716272      format: int3262736274  - `archived_at: string or null`62756276    A timestamp in RFC 3339 format62776278    format: date-time62796280  - `created_at: string`62816282    A timestamp in RFC 3339 format62836284    format: date-time62856286  - `description: string or null`62876288    Description of what the deployment does.62896290  - `environment_id: string`62916292    ID of the `environment` where sessions run.62936294  - `initial_events: array of BetaManagedAgentsDeploymentInitialEvent`62956296    Events sent to each session immediately after creation.62976298    - `BetaManagedAgentsDeploymentUserMessageEvent object`62996300      A user message sent to the session.63016302      - `type: "user.message"`63036304      - `content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsRedactedBlock`63056306        Array of content blocks for the user message.63076308        - `BetaManagedAgentsTextBlock object`63096310          Regular text content.63116312          - `type: "text"`63136314          - `text: string`63156316            The text content.63176318            minLength: 163196320        - `BetaManagedAgentsImageBlock object`63216322          Image content specified directly as base64 data or as a reference via a URL.63236324          - `type: "image"`63256326          - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`63276328            Union type for image source variants.63296330            - `BetaManagedAgentsBase64ImageSource object`63316332              Base64-encoded image data.63336334              - `type: "base64"`63356336              - `data: string`63376338                Base64-encoded image data.63396340                minLength: 163416342              - `media_type: string`63436344                MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").63456346                minLength: 163476348            - `BetaManagedAgentsURLImageSource object`63496350              Image referenced by URL.63516352              - `type: "url"`63536354              - `url: string`63556356                URL of the image to fetch.63576358                minLength: 163596360            - `BetaManagedAgentsFileImageSource object`63616362              Image referenced by file ID.63636364              - `type: "file"`63656366              - `file_id: string`63676368                ID of a previously uploaded file.63696370                minLength: 163716372        - `BetaManagedAgentsDocumentBlock object`63736374          Document content, either specified directly as base64 data, as text, or as a reference via a URL.63756376          - `type: "document"`63776378          - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`63796380            Union type for document source variants.63816382            - `BetaManagedAgentsBase64DocumentSource object`63836384              Base64-encoded document data.63856386              - `type: "base64"`63876388              - `data: string`63896390                Base64-encoded document data.63916392                minLength: 163936394              - `media_type: string`63956396                MIME type of the document (e.g., "application/pdf").63976398                minLength: 163996400            - `BetaManagedAgentsPlainTextDocumentSource object`64016402              Plain text document content.64036404              - `type: "text"`64056406              - `data: string`64076408                The plain text content.64096410                minLength: 164116412              - `media_type: "text/plain"`64136414                MIME type of the text content. Must be "text/plain".64156416            - `BetaManagedAgentsURLDocumentSource object`64176418              Document referenced by URL.64196420              - `type: "url"`64216422              - `url: string`64236424                URL of the document to fetch.64256426                minLength: 164276428            - `BetaManagedAgentsFileDocumentSource object`64296430              Document referenced by file ID.64316432              - `type: "file"`64336434              - `file_id: string`64356436                ID of a previously uploaded file.64376438                minLength: 164396440          - `context: optional string or null`64416442            Additional context about the document for the model.64436444          - `title: optional string or null`64456446            The title of the document.64476448        - `BetaManagedAgentsRedactedBlock object`64496450          Placeholder for content withheld by Anthropic model policy.64516452          - `type: "redacted"`64536454    - `BetaManagedAgentsDeploymentUserDefineOutcomeEvent object`64556456      An outcome the agent should work toward. The agent begins work on receipt.64576458      - `type: "user.define_outcome"`64596460      - `description: string`64616462        What the agent should produce. This is the task specification.64636464      - `rubric: BetaManagedAgentsFileRubric or BetaManagedAgentsTextRubric`64656466        Rubric for grading the quality of an outcome.64676468        - `BetaManagedAgentsFileRubric object`64696470          Rubric referenced by a file uploaded via the Files API.64716472          - `type: "file"`64736474          - `file_id: string`64756476            ID of the rubric file.64776478        - `BetaManagedAgentsTextRubric object`64796480          Rubric content provided inline as text.64816482          - `type: "text"`64836484          - `content: string`64856486            Rubric content. Plain text or markdown — the grader treats it as freeform text.64876488      - `max_iterations: optional number or null`64896490        Eval→revision cycles before giving up. Default 3, max 20.64916492        format: int3264936494    - `BetaManagedAgentsDeploymentSystemMessageEvent object`64956496      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.64976498      - `type: "system.message"`64996500      - `content: array of BetaManagedAgentsSystemContentBlock`65016502        System content blocks to append. Text-only.65036504        - `type: "text"`65056506        - `text: string`65076508          The text content.65096510          minLength: 165116512  - `metadata: map[string]`65136514    Arbitrary key-value metadata. Maximum 16 pairs.65156516  - `name: string`65176518    Human-readable name.65196520  - `paused_reason: BetaManagedAgentsDeploymentPausedReason or null`65216522    Why a deployment is paused. Non-null exactly when `status` is `paused`.65236524    - `BetaManagedAgentsManualDeploymentPausedReason object`65256526      The caller invoked the pause endpoint on the deployment.65276528      - `type: "manual"`65296530    - `BetaManagedAgentsErrorDeploymentPausedReason object`65316532      A scheduled fire recorded a failed run whose error auto-pauses the deployment.65336534      - `type: "error"`65356536      - `error: BetaManagedAgentsDeploymentPausedReasonError`65376538        The error that triggered an auto-pause. Matches the failed run's `error.type`.65396540        - `BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError object`65416542          The deployment's environment was archived.65436544          - `type: "environment_archived_error"`65456546        - `BetaManagedAgentsAgentArchivedDeploymentPausedReasonError object`65476548          The deployment's agent was archived.65496550          - `type: "agent_archived_error"`65516552        - `BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError object`65536554          The deployment's environment no longer exists.65556556          - `type: "environment_not_found_error"`65576558        - `BetaManagedAgentsVaultNotFoundDeploymentPausedReasonError object`65596560          A vault referenced by the deployment no longer exists.65616562          - `type: "vault_not_found_error"`65636564        - `BetaManagedAgentsFileNotFoundDeploymentPausedReasonError object`65656566          A file resource referenced by the deployment no longer exists.65676568          - `type: "file_not_found_error"`65696570        - `BetaManagedAgentsSessionResourceNotFoundDeploymentPausedReasonError object`65716572          A referenced resource no longer exists and its kind was not reported.65736574          - `type: "session_resource_not_found_error"`65756576        - `BetaManagedAgentsWorkspaceArchivedDeploymentPausedReasonError object`65776578          The deployment's workspace was archived.65796580          - `type: "workspace_archived_error"`65816582        - `BetaManagedAgentsOrganizationDisabledDeploymentPausedReasonError object`65836584          The deployment's organization is disabled.65856586          - `type: "organization_disabled_error"`65876588        - `BetaManagedAgentsMemoryStoreArchivedDeploymentPausedReasonError object`65896590          A memory store referenced by the deployment is archived.65916592          - `type: "memory_store_archived_error"`65936594        - `BetaManagedAgentsSkillNotFoundDeploymentPausedReasonError object`65956596          A skill referenced by the deployment's agent no longer exists.65976598          - `type: "skill_not_found_error"`65996600        - `BetaManagedAgentsVaultArchivedDeploymentPausedReasonError object`66016602          A vault referenced by the deployment is archived.66036604          - `type: "vault_archived_error"`66056606        - `BetaManagedAgentsUnknownDeploymentPausedReasonError object`66076608          An unrecognized error auto-paused the deployment. A fallback variant; matches a run whose `error.type` is `unknown_error`.66096610          - `type: "unknown_error"`66116612        - `BetaManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonError object`66136614          The deployment configures resources, but its environment is self-hosted and cannot mount them.66156616          - `type: "self_hosted_resources_unsupported_error"`66176618        - `BetaManagedAgentsMCPEgressBlockedDeploymentPausedReasonError object`66196620          An MCP server host used by the deployment's agent is blocked by the environment's network policy.66216622          - `type: "mcp_egress_blocked_error"`66236624  - `resources: array of BetaManagedAgentsSessionResourceConfig`66256626    Resources attached to sessions created from this deployment. Echoes the input minus write-only credentials.66276628    - `BetaManagedAgentsGitHubRepositoryResourceConfig object`66296630      A GitHub repository mounted into each session's container. The authorization token is write-only and never returned.66316632      - `type: "github_repository"`66336634      - `url: string`66356636        Github URL of the repository66376638      - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`66396640        Branch or commit to check out. Defaults to the repository's default branch.66416642        - `BetaManagedAgentsBranchCheckout object`66436644          - `type: "branch"`66456646          - `name: string`66476648            Branch name to check out.66496650            minLength: 1, maxLength: 25566516652        - `BetaManagedAgentsCommitCheckout object`66536654          - `type: "commit"`66556656          - `sha: string`66576658            Full commit SHA to check out.66596660            minLength: 7, maxLength: 6466616662      - `mount_path: optional string or null`66636664        Mount path in the container. Defaults to `/workspace/<repo-name>`.66656666    - `BetaManagedAgentsFileResourceConfig object`66676668      A file mounted into each session's container.66696670      - `type: "file"`66716672      - `file_id: string`66736674        ID of a previously uploaded file.66756676      - `mount_path: optional string or null`66776678        Mount path in the container. Defaults to `/mnt/session/uploads/<file_id>`.66796680    - `BetaManagedAgentsMemoryStoreResourceConfig object`66816682      A memory store attached to each session created from this deployment.66836684      - `type: "memory_store"`66856686      - `memory_store_id: string`66876688        The memory store ID (memstore_...). Must belong to the caller's organization and workspace.66896690      - `access: optional "read_write" or "read_only" or null`66916692        Access mode for an attached memory store.66936694        - `"read_write"`66956696        - `"read_only"`66976698      - `instructions: optional string or null`66996700        Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.67016702  - `schedule: BetaManagedAgentsSchedule or null`67036704    5-field POSIX cron schedule with computed runtime timestamps.67056706    - `type: "cron"`67076708    - `expression: string`67096710      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).67116712      minLength: 1, maxLength: 25667136714    - `timezone: string`67156716      IANA timezone identifier (e.g., "America/Los_Angeles", "UTC").67176718      minLength: 167196720    - `last_run_at: optional string or null`67216722      A timestamp in RFC 3339 format67236724      format: date-time67256726    - `upcoming_runs_at: optional array of string`67276728      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.67296730  - `status: BetaManagedAgentsDeploymentStatus`67316732    Lifecycle status of a deployment.67336734    - `"active"`67356736    - `"paused"`67376738  - `updated_at: string`67396740    A timestamp in RFC 3339 format67416742    format: date-time67436744  - `vault_ids: array of string`67456746    Vault IDs supplying stored credentials for sessions created from this deployment.67476748  - `budget: optional BetaManagedAgentsBudgetLimit or null`67496750    A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.67516752    - `type: "limit"`67536754    - `max_list_cost: BetaMonetaryAmount`67556756      A monetary amount in a specific currency.67576758      - `amount: string`67596760        Amount in minor units of the currency, as an integer decimal string with no leading zeros: "2500" is $25.00 and "50" is fifty cents. A string rather than a number so no float rounding is ever applied.67616762      - `currency: BetaCurrency`67636764        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.67656766### Beta Managed Agents Deployment Initial Event67676768- `BetaManagedAgentsDeploymentInitialEvent = BetaManagedAgentsDeploymentUserMessageEvent or BetaManagedAgentsDeploymentUserDefineOutcomeEvent or BetaManagedAgentsDeploymentSystemMessageEvent`67696770  An event sent to a session immediately after it is created. Supports `user.message`, `user.define_outcome`, and `system.message`.67716772  - `BetaManagedAgentsDeploymentUserMessageEvent object`67736774    A user message sent to the session.67756776    - `type: "user.message"`67776778    - `content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsRedactedBlock`67796780      Array of content blocks for the user message.67816782      - `BetaManagedAgentsTextBlock object`67836784        Regular text content.67856786        - `type: "text"`67876788        - `text: string`67896790          The text content.67916792          minLength: 167936794      - `BetaManagedAgentsImageBlock object`67956796        Image content specified directly as base64 data or as a reference via a URL.67976798        - `type: "image"`67996800        - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`68016802          Union type for image source variants.68036804          - `BetaManagedAgentsBase64ImageSource object`68056806            Base64-encoded image data.68076808            - `type: "base64"`68096810            - `data: string`68116812              Base64-encoded image data.68136814              minLength: 168156816            - `media_type: string`68176818              MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").68196820              minLength: 168216822          - `BetaManagedAgentsURLImageSource object`68236824            Image referenced by URL.68256826            - `type: "url"`68276828            - `url: string`68296830              URL of the image to fetch.68316832              minLength: 168336834          - `BetaManagedAgentsFileImageSource object`68356836            Image referenced by file ID.68376838            - `type: "file"`68396840            - `file_id: string`68416842              ID of a previously uploaded file.68436844              minLength: 168456846      - `BetaManagedAgentsDocumentBlock object`68476848        Document content, either specified directly as base64 data, as text, or as a reference via a URL.68496850        - `type: "document"`68516852        - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`68536854          Union type for document source variants.68556856          - `BetaManagedAgentsBase64DocumentSource object`68576858            Base64-encoded document data.68596860            - `type: "base64"`68616862            - `data: string`68636864              Base64-encoded document data.68656866              minLength: 168676868            - `media_type: string`68696870              MIME type of the document (e.g., "application/pdf").68716872              minLength: 168736874          - `BetaManagedAgentsPlainTextDocumentSource object`68756876            Plain text document content.68776878            - `type: "text"`68796880            - `data: string`68816882              The plain text content.68836884              minLength: 168856886            - `media_type: "text/plain"`68876888              MIME type of the text content. Must be "text/plain".68896890          - `BetaManagedAgentsURLDocumentSource object`68916892            Document referenced by URL.68936894            - `type: "url"`68956896            - `url: string`68976898              URL of the document to fetch.68996900              minLength: 169016902          - `BetaManagedAgentsFileDocumentSource object`69036904            Document referenced by file ID.69056906            - `type: "file"`69076908            - `file_id: string`69096910              ID of a previously uploaded file.69116912              minLength: 169136914        - `context: optional string or null`69156916          Additional context about the document for the model.69176918        - `title: optional string or null`69196920          The title of the document.69216922      - `BetaManagedAgentsRedactedBlock object`69236924        Placeholder for content withheld by Anthropic model policy.69256926        - `type: "redacted"`69276928  - `BetaManagedAgentsDeploymentUserDefineOutcomeEvent object`69296930    An outcome the agent should work toward. The agent begins work on receipt.69316932    - `type: "user.define_outcome"`69336934    - `description: string`69356936      What the agent should produce. This is the task specification.69376938    - `rubric: BetaManagedAgentsFileRubric or BetaManagedAgentsTextRubric`69396940      Rubric for grading the quality of an outcome.69416942      - `BetaManagedAgentsFileRubric object`69436944        Rubric referenced by a file uploaded via the Files API.69456946        - `type: "file"`69476948        - `file_id: string`69496950          ID of the rubric file.69516952      - `BetaManagedAgentsTextRubric object`69536954        Rubric content provided inline as text.69556956        - `type: "text"`69576958        - `content: string`69596960          Rubric content. Plain text or markdown — the grader treats it as freeform text.69616962    - `max_iterations: optional number or null`69636964      Eval→revision cycles before giving up. Default 3, max 20.69656966      format: int3269676968  - `BetaManagedAgentsDeploymentSystemMessageEvent object`69696970    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.69716972    - `type: "system.message"`69736974    - `content: array of BetaManagedAgentsSystemContentBlock`69756976      System content blocks to append. Text-only.69776978      - `type: "text"`69796980      - `text: string`69816982        The text content.69836984        minLength: 169856986### Beta Managed Agents Deployment Initial Event Params69876988- `BetaManagedAgentsDeploymentInitialEventParams = BetaManagedAgentsUserMessageEventParams or BetaManagedAgentsUserDefineOutcomeEventParams or BetaManagedAgentsSystemMessageEventParams`69896990  An event sent to a session immediately after it is created. Supports `user.message`, `user.define_outcome`, and `system.message`.69916992  - `BetaManagedAgentsUserMessageEventParams object`69936994    Parameters for sending a user message to the session.69956996    - `type: "user.message"`69976998    - `content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsRedactedBlock`69997000      Array of content blocks for the user message.70017002      - `BetaManagedAgentsTextBlock object`70037004        Regular text content.70057006        - `type: "text"`70077008        - `text: string`70097010          The text content.70117012          minLength: 170137014      - `BetaManagedAgentsImageBlock object`70157016        Image content specified directly as base64 data or as a reference via a URL.70177018        - `type: "image"`70197020        - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`70217022          Union type for image source variants.70237024          - `BetaManagedAgentsBase64ImageSource object`70257026            Base64-encoded image data.70277028            - `type: "base64"`70297030            - `data: string`70317032              Base64-encoded image data.70337034              minLength: 170357036            - `media_type: string`70377038              MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").70397040              minLength: 170417042          - `BetaManagedAgentsURLImageSource object`70437044            Image referenced by URL.70457046            - `type: "url"`70477048            - `url: string`70497050              URL of the image to fetch.70517052              minLength: 170537054          - `BetaManagedAgentsFileImageSource object`70557056            Image referenced by file ID.70577058            - `type: "file"`70597060            - `file_id: string`70617062              ID of a previously uploaded file.70637064              minLength: 170657066      - `BetaManagedAgentsDocumentBlock object`70677068        Document content, either specified directly as base64 data, as text, or as a reference via a URL.70697070        - `type: "document"`70717072        - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`70737074          Union type for document source variants.70757076          - `BetaManagedAgentsBase64DocumentSource object`70777078            Base64-encoded document data.70797080            - `type: "base64"`70817082            - `data: string`70837084              Base64-encoded document data.70857086              minLength: 170877088            - `media_type: string`70897090              MIME type of the document (e.g., "application/pdf").70917092              minLength: 170937094          - `BetaManagedAgentsPlainTextDocumentSource object`70957096            Plain text document content.70977098            - `type: "text"`70997100            - `data: string`71017102              The plain text content.71037104              minLength: 171057106            - `media_type: "text/plain"`71077108              MIME type of the text content. Must be "text/plain".71097110          - `BetaManagedAgentsURLDocumentSource object`71117112            Document referenced by URL.71137114            - `type: "url"`71157116            - `url: string`71177118              URL of the document to fetch.71197120              minLength: 171217122          - `BetaManagedAgentsFileDocumentSource object`71237124            Document referenced by file ID.71257126            - `type: "file"`71277128            - `file_id: string`71297130              ID of a previously uploaded file.71317132              minLength: 171337134        - `context: optional string or null`71357136          Additional context about the document for the model.71377138        - `title: optional string or null`71397140          The title of the document.71417142      - `BetaManagedAgentsRedactedBlock object`71437144        Placeholder for content withheld by Anthropic model policy.71457146        - `type: "redacted"`71477148  - `BetaManagedAgentsUserDefineOutcomeEventParams object`71497150    Parameters for defining an outcome the agent should work toward. The agent begins work on receipt.71517152    - `type: "user.define_outcome"`71537154    - `description: string`71557156      What the agent should produce. This is the task specification.71577158    - `rubric: BetaManagedAgentsFileRubricParams or BetaManagedAgentsTextRubricParams`71597160      Rubric for grading the quality of an outcome.71617162      - `BetaManagedAgentsFileRubricParams object`71637164        Rubric referenced by a file uploaded via the Files API.71657166        - `type: "file"`71677168        - `file_id: string`71697170          ID of the rubric file.71717172      - `BetaManagedAgentsTextRubricParams object`71737174        Rubric content provided inline as text.71757176        - `type: "text"`71777178        - `content: string`71797180          Rubric content. Plain text or markdown — the grader treats it as freeform text. Maximum 262144 characters.71817182          maxLength: 26214471837184    - `max_iterations: optional number or null`71857186      Eval→revision cycles before giving up. Default 3, max 20.71877188      format: int3271897190  - `BetaManagedAgentsSystemMessageEventParams object`71917192    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.71937194    - `type: "system.message"`71957196    - `content: array of BetaManagedAgentsSystemContentBlock`71977198      System content blocks to append. Text-only.71997200      - `type: "text"`72017202      - `text: string`72037204        The text content.72057206        minLength: 172077208### Beta Managed Agents Deployment Paused Reason72097210- `BetaManagedAgentsDeploymentPausedReason = BetaManagedAgentsManualDeploymentPausedReason or BetaManagedAgentsErrorDeploymentPausedReason`72117212  Why a deployment is paused. Non-null exactly when `status` is `paused`.72137214  - `BetaManagedAgentsManualDeploymentPausedReason object`72157216    The caller invoked the pause endpoint on the deployment.72177218    - `type: "manual"`72197220  - `BetaManagedAgentsErrorDeploymentPausedReason object`72217222    A scheduled fire recorded a failed run whose error auto-pauses the deployment.72237224    - `type: "error"`72257226    - `error: BetaManagedAgentsDeploymentPausedReasonError`72277228      The error that triggered an auto-pause. Matches the failed run's `error.type`.72297230      - `BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError object`72317232        The deployment's environment was archived.72337234        - `type: "environment_archived_error"`72357236      - `BetaManagedAgentsAgentArchivedDeploymentPausedReasonError object`72377238        The deployment's agent was archived.72397240        - `type: "agent_archived_error"`72417242      - `BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError object`72437244        The deployment's environment no longer exists.72457246        - `type: "environment_not_found_error"`72477248      - `BetaManagedAgentsVaultNotFoundDeploymentPausedReasonError object`72497250        A vault referenced by the deployment no longer exists.72517252        - `type: "vault_not_found_error"`72537254      - `BetaManagedAgentsFileNotFoundDeploymentPausedReasonError object`72557256        A file resource referenced by the deployment no longer exists.72577258        - `type: "file_not_found_error"`72597260      - `BetaManagedAgentsSessionResourceNotFoundDeploymentPausedReasonError object`72617262        A referenced resource no longer exists and its kind was not reported.72637264        - `type: "session_resource_not_found_error"`72657266      - `BetaManagedAgentsWorkspaceArchivedDeploymentPausedReasonError object`72677268        The deployment's workspace was archived.72697270        - `type: "workspace_archived_error"`72717272      - `BetaManagedAgentsOrganizationDisabledDeploymentPausedReasonError object`72737274        The deployment's organization is disabled.72757276        - `type: "organization_disabled_error"`72777278      - `BetaManagedAgentsMemoryStoreArchivedDeploymentPausedReasonError object`72797280        A memory store referenced by the deployment is archived.72817282        - `type: "memory_store_archived_error"`72837284      - `BetaManagedAgentsSkillNotFoundDeploymentPausedReasonError object`72857286        A skill referenced by the deployment's agent no longer exists.72877288        - `type: "skill_not_found_error"`72897290      - `BetaManagedAgentsVaultArchivedDeploymentPausedReasonError object`72917292        A vault referenced by the deployment is archived.72937294        - `type: "vault_archived_error"`72957296      - `BetaManagedAgentsUnknownDeploymentPausedReasonError object`72977298        An unrecognized error auto-paused the deployment. A fallback variant; matches a run whose `error.type` is `unknown_error`.72997300        - `type: "unknown_error"`73017302      - `BetaManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonError object`73037304        The deployment configures resources, but its environment is self-hosted and cannot mount them.73057306        - `type: "self_hosted_resources_unsupported_error"`73077308      - `BetaManagedAgentsMCPEgressBlockedDeploymentPausedReasonError object`73097310        An MCP server host used by the deployment's agent is blocked by the environment's network policy.73117312        - `type: "mcp_egress_blocked_error"`73137314### Beta Managed Agents Deployment Paused Reason Error73157316- `BetaManagedAgentsDeploymentPausedReasonError = BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError or BetaManagedAgentsAgentArchivedDeploymentPausedReasonError or BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError or 11 more`73177318  The error that triggered an auto-pause. Matches the failed run's `error.type`.73197320  - `BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError object`73217322    The deployment's environment was archived.73237324    - `type: "environment_archived_error"`73257326  - `BetaManagedAgentsAgentArchivedDeploymentPausedReasonError object`73277328    The deployment's agent was archived.73297330    - `type: "agent_archived_error"`73317332  - `BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError object`73337334    The deployment's environment no longer exists.73357336    - `type: "environment_not_found_error"`73377338  - `BetaManagedAgentsVaultNotFoundDeploymentPausedReasonError object`73397340    A vault referenced by the deployment no longer exists.73417342    - `type: "vault_not_found_error"`73437344  - `BetaManagedAgentsFileNotFoundDeploymentPausedReasonError object`73457346    A file resource referenced by the deployment no longer exists.73477348    - `type: "file_not_found_error"`73497350  - `BetaManagedAgentsSessionResourceNotFoundDeploymentPausedReasonError object`73517352    A referenced resource no longer exists and its kind was not reported.73537354    - `type: "session_resource_not_found_error"`73557356  - `BetaManagedAgentsWorkspaceArchivedDeploymentPausedReasonError object`73577358    The deployment's workspace was archived.73597360    - `type: "workspace_archived_error"`73617362  - `BetaManagedAgentsOrganizationDisabledDeploymentPausedReasonError object`73637364    The deployment's organization is disabled.73657366    - `type: "organization_disabled_error"`73677368  - `BetaManagedAgentsMemoryStoreArchivedDeploymentPausedReasonError object`73697370    A memory store referenced by the deployment is archived.73717372    - `type: "memory_store_archived_error"`73737374  - `BetaManagedAgentsSkillNotFoundDeploymentPausedReasonError object`73757376    A skill referenced by the deployment's agent no longer exists.73777378    - `type: "skill_not_found_error"`73797380  - `BetaManagedAgentsVaultArchivedDeploymentPausedReasonError object`73817382    A vault referenced by the deployment is archived.73837384    - `type: "vault_archived_error"`73857386  - `BetaManagedAgentsUnknownDeploymentPausedReasonError object`73877388    An unrecognized error auto-paused the deployment. A fallback variant; matches a run whose `error.type` is `unknown_error`.73897390    - `type: "unknown_error"`73917392  - `BetaManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonError object`73937394    The deployment configures resources, but its environment is self-hosted and cannot mount them.73957396    - `type: "self_hosted_resources_unsupported_error"`73977398  - `BetaManagedAgentsMCPEgressBlockedDeploymentPausedReasonError object`73997400    An MCP server host used by the deployment's agent is blocked by the environment's network policy.74017402    - `type: "mcp_egress_blocked_error"`74037404### Beta Managed Agents Deployment Status74057406- `BetaManagedAgentsDeploymentStatus = "active" or "paused"`74077408  Lifecycle status of a deployment.74097410  - `"active"`74117412  - `"paused"`74137414### Beta Managed Agents Deployment System Message Event74157416- `BetaManagedAgentsDeploymentSystemMessageEvent object`74177418  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.74197420  - `type: "system.message"`74217422  - `content: array of BetaManagedAgentsSystemContentBlock`74237424    System content blocks to append. Text-only.74257426    - `type: "text"`74277428    - `text: string`74297430      The text content.74317432      minLength: 174337434### Beta Managed Agents Deployment User Define Outcome Event74357436- `BetaManagedAgentsDeploymentUserDefineOutcomeEvent object`74377438  An outcome the agent should work toward. The agent begins work on receipt.74397440  - `type: "user.define_outcome"`74417442  - `description: string`74437444    What the agent should produce. This is the task specification.74457446  - `rubric: BetaManagedAgentsFileRubric or BetaManagedAgentsTextRubric`74477448    Rubric for grading the quality of an outcome.74497450    - `BetaManagedAgentsFileRubric object`74517452      Rubric referenced by a file uploaded via the Files API.74537454      - `type: "file"`74557456      - `file_id: string`74577458        ID of the rubric file.74597460    - `BetaManagedAgentsTextRubric object`74617462      Rubric content provided inline as text.74637464      - `type: "text"`74657466      - `content: string`74677468        Rubric content. Plain text or markdown — the grader treats it as freeform text.74697470  - `max_iterations: optional number or null`74717472    Eval→revision cycles before giving up. Default 3, max 20.74737474    format: int3274757476### Beta Managed Agents Deployment User Message Event74777478- `BetaManagedAgentsDeploymentUserMessageEvent object`74797480  A user message sent to the session.74817482  - `type: "user.message"`74837484  - `content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsRedactedBlock`74857486    Array of content blocks for the user message.74877488    - `BetaManagedAgentsTextBlock object`74897490      Regular text content.74917492      - `type: "text"`74937494      - `text: string`74957496        The text content.74977498        minLength: 174997500    - `BetaManagedAgentsImageBlock object`75017502      Image content specified directly as base64 data or as a reference via a URL.75037504      - `type: "image"`75057506      - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`75077508        Union type for image source variants.75097510        - `BetaManagedAgentsBase64ImageSource object`75117512          Base64-encoded image data.75137514          - `type: "base64"`75157516          - `data: string`75177518            Base64-encoded image data.75197520            minLength: 175217522          - `media_type: string`75237524            MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").75257526            minLength: 175277528        - `BetaManagedAgentsURLImageSource object`75297530          Image referenced by URL.75317532          - `type: "url"`75337534          - `url: string`75357536            URL of the image to fetch.75377538            minLength: 175397540        - `BetaManagedAgentsFileImageSource object`75417542          Image referenced by file ID.75437544          - `type: "file"`75457546          - `file_id: string`75477548            ID of a previously uploaded file.75497550            minLength: 175517552    - `BetaManagedAgentsDocumentBlock object`75537554      Document content, either specified directly as base64 data, as text, or as a reference via a URL.75557556      - `type: "document"`75577558      - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`75597560        Union type for document source variants.75617562        - `BetaManagedAgentsBase64DocumentSource object`75637564          Base64-encoded document data.75657566          - `type: "base64"`75677568          - `data: string`75697570            Base64-encoded document data.75717572            minLength: 175737574          - `media_type: string`75757576            MIME type of the document (e.g., "application/pdf").75777578            minLength: 175797580        - `BetaManagedAgentsPlainTextDocumentSource object`75817582          Plain text document content.75837584          - `type: "text"`75857586          - `data: string`75877588            The plain text content.75897590            minLength: 175917592          - `media_type: "text/plain"`75937594            MIME type of the text content. Must be "text/plain".75957596        - `BetaManagedAgentsURLDocumentSource object`75977598          Document referenced by URL.75997600          - `type: "url"`76017602          - `url: string`76037604            URL of the document to fetch.76057606            minLength: 176077608        - `BetaManagedAgentsFileDocumentSource object`76097610          Document referenced by file ID.76117612          - `type: "file"`76137614          - `file_id: string`76157616            ID of a previously uploaded file.76177618            minLength: 176197620      - `context: optional string or null`76217622        Additional context about the document for the model.76237624      - `title: optional string or null`76257626        The title of the document.76277628    - `BetaManagedAgentsRedactedBlock object`76297630      Placeholder for content withheld by Anthropic model policy.76317632      - `type: "redacted"`76337634### Beta Managed Agents Environment Archived Deployment Paused Reason Error76357636- `BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError object`76377638  The deployment's environment was archived.76397640  - `type: "environment_archived_error"`76417642### Beta Managed Agents Environment Not Found Deployment Paused Reason Error76437644- `BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError object`76457646  The deployment's environment no longer exists.76477648  - `type: "environment_not_found_error"`76497650### Beta Managed Agents Error Deployment Paused Reason76517652- `BetaManagedAgentsErrorDeploymentPausedReason object`76537654  A scheduled fire recorded a failed run whose error auto-pauses the deployment.76557656  - `type: "error"`76577658  - `error: BetaManagedAgentsDeploymentPausedReasonError`76597660    The error that triggered an auto-pause. Matches the failed run's `error.type`.76617662    - `BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError object`76637664      The deployment's environment was archived.76657666      - `type: "environment_archived_error"`76677668    - `BetaManagedAgentsAgentArchivedDeploymentPausedReasonError object`76697670      The deployment's agent was archived.76717672      - `type: "agent_archived_error"`76737674    - `BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError object`76757676      The deployment's environment no longer exists.76777678      - `type: "environment_not_found_error"`76797680    - `BetaManagedAgentsVaultNotFoundDeploymentPausedReasonError object`76817682      A vault referenced by the deployment no longer exists.76837684      - `type: "vault_not_found_error"`76857686    - `BetaManagedAgentsFileNotFoundDeploymentPausedReasonError object`76877688      A file resource referenced by the deployment no longer exists.76897690      - `type: "file_not_found_error"`76917692    - `BetaManagedAgentsSessionResourceNotFoundDeploymentPausedReasonError object`76937694      A referenced resource no longer exists and its kind was not reported.76957696      - `type: "session_resource_not_found_error"`76977698    - `BetaManagedAgentsWorkspaceArchivedDeploymentPausedReasonError object`76997700      The deployment's workspace was archived.77017702      - `type: "workspace_archived_error"`77037704    - `BetaManagedAgentsOrganizationDisabledDeploymentPausedReasonError object`77057706      The deployment's organization is disabled.77077708      - `type: "organization_disabled_error"`77097710    - `BetaManagedAgentsMemoryStoreArchivedDeploymentPausedReasonError object`77117712      A memory store referenced by the deployment is archived.77137714      - `type: "memory_store_archived_error"`77157716    - `BetaManagedAgentsSkillNotFoundDeploymentPausedReasonError object`77177718      A skill referenced by the deployment's agent no longer exists.77197720      - `type: "skill_not_found_error"`77217722    - `BetaManagedAgentsVaultArchivedDeploymentPausedReasonError object`77237724      A vault referenced by the deployment is archived.77257726      - `type: "vault_archived_error"`77277728    - `BetaManagedAgentsUnknownDeploymentPausedReasonError object`77297730      An unrecognized error auto-paused the deployment. A fallback variant; matches a run whose `error.type` is `unknown_error`.77317732      - `type: "unknown_error"`77337734    - `BetaManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonError object`77357736      The deployment configures resources, but its environment is self-hosted and cannot mount them.77377738      - `type: "self_hosted_resources_unsupported_error"`77397740    - `BetaManagedAgentsMCPEgressBlockedDeploymentPausedReasonError object`77417742      An MCP server host used by the deployment's agent is blocked by the environment's network policy.77437744      - `type: "mcp_egress_blocked_error"`77457746### Beta Managed Agents File Not Found Deployment Paused Reason Error77477748- `BetaManagedAgentsFileNotFoundDeploymentPausedReasonError object`77497750  A file resource referenced by the deployment no longer exists.77517752  - `type: "file_not_found_error"`77537754### Beta Managed Agents File Resource Config77557756- `BetaManagedAgentsFileResourceConfig object`77577758  A file mounted into each session's container.77597760  - `type: "file"`77617762  - `file_id: string`77637764    ID of a previously uploaded file.77657766  - `mount_path: optional string or null`77677768    Mount path in the container. Defaults to `/mnt/session/uploads/<file_id>`.77697770### Beta Managed Agents GitHub Repository Resource Config77717772- `BetaManagedAgentsGitHubRepositoryResourceConfig object`77737774  A GitHub repository mounted into each session's container. The authorization token is write-only and never returned.77757776  - `type: "github_repository"`77777778  - `url: string`77797780    Github URL of the repository77817782  - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`77837784    Branch or commit to check out. Defaults to the repository's default branch.77857786    - `BetaManagedAgentsBranchCheckout object`77877788      - `type: "branch"`77897790      - `name: string`77917792        Branch name to check out.77937794        minLength: 1, maxLength: 25577957796    - `BetaManagedAgentsCommitCheckout object`77977798      - `type: "commit"`77997800      - `sha: string`78017802        Full commit SHA to check out.78037804        minLength: 7, maxLength: 6478057806  - `mount_path: optional string or null`78077808    Mount path in the container. Defaults to `/workspace/<repo-name>`.78097810### Beta Managed Agents Manual Deployment Paused Reason78117812- `BetaManagedAgentsManualDeploymentPausedReason object`78137814  The caller invoked the pause endpoint on the deployment.78157816  - `type: "manual"`78177818### Beta Managed Agents MCP Egress Blocked Deployment Paused Reason Error78197820- `BetaManagedAgentsMCPEgressBlockedDeploymentPausedReasonError object`78217822  An MCP server host used by the deployment's agent is blocked by the environment's network policy.78237824  - `type: "mcp_egress_blocked_error"`78257826### Beta Managed Agents Memory Store Archived Deployment Paused Reason Error78277828- `BetaManagedAgentsMemoryStoreArchivedDeploymentPausedReasonError object`78297830  A memory store referenced by the deployment is archived.78317832  - `type: "memory_store_archived_error"`78337834### Beta Managed Agents Memory Store Resource Config78357836- `BetaManagedAgentsMemoryStoreResourceConfig object`78377838  A memory store attached to each session created from this deployment.78397840  - `type: "memory_store"`78417842  - `memory_store_id: string`78437844    The memory store ID (memstore_...). Must belong to the caller's organization and workspace.78457846  - `access: optional "read_write" or "read_only" or null`78477848    Access mode for an attached memory store.78497850    - `"read_write"`78517852    - `"read_only"`78537854  - `instructions: optional string or null`78557856    Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.78577858### Beta Managed Agents Organization Disabled Deployment Paused Reason Error78597860- `BetaManagedAgentsOrganizationDisabledDeploymentPausedReasonError object`78617862  The deployment's organization is disabled.78637864  - `type: "organization_disabled_error"`78657866### Beta Managed Agents Schedule78677868- `BetaManagedAgentsSchedule object`78697870  5-field POSIX cron schedule with computed runtime timestamps.78717872  - `type: "cron"`78737874  - `expression: string`78757876    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).78777878    minLength: 1, maxLength: 25678797880  - `timezone: string`78817882    IANA timezone identifier (e.g., "America/Los_Angeles", "UTC").78837884    minLength: 178857886  - `last_run_at: optional string or null`78877888    A timestamp in RFC 3339 format78897890    format: date-time78917892  - `upcoming_runs_at: optional array of string`78937894    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.78957896### Beta Managed Agents Schedule Params78977898- `BetaManagedAgentsScheduleParams object`78997900  5-field POSIX cron schedule. Literal wall-clock matching in the configured timezone.79017902  - `type: "cron"`79037904  - `expression: string`79057906    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).79077908    minLength: 1, maxLength: 25679097910  - `timezone: string`79117912    Required. IANA timezone identifier (e.g., "America/Los_Angeles", "UTC"). Validated against the IANA timezone database.79137914    minLength: 179157916### Beta Managed Agents Self Hosted Resources Unsupported Deployment Paused Reason Error79177918- `BetaManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonError object`79197920  The deployment configures resources, but its environment is self-hosted and cannot mount them.79217922  - `type: "self_hosted_resources_unsupported_error"`79237924### Beta Managed Agents Session Resource Config79257926- `BetaManagedAgentsSessionResourceConfig = BetaManagedAgentsGitHubRepositoryResourceConfig or BetaManagedAgentsFileResourceConfig or BetaManagedAgentsMemoryStoreResourceConfig`79277928  A configured session resource. Echoes the input minus write-only credentials.79297930  - `BetaManagedAgentsGitHubRepositoryResourceConfig object`79317932    A GitHub repository mounted into each session's container. The authorization token is write-only and never returned.79337934    - `type: "github_repository"`79357936    - `url: string`79377938      Github URL of the repository79397940    - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`79417942      Branch or commit to check out. Defaults to the repository's default branch.79437944      - `BetaManagedAgentsBranchCheckout object`79457946        - `type: "branch"`79477948        - `name: string`79497950          Branch name to check out.79517952          minLength: 1, maxLength: 25579537954      - `BetaManagedAgentsCommitCheckout object`79557956        - `type: "commit"`79577958        - `sha: string`79597960          Full commit SHA to check out.79617962          minLength: 7, maxLength: 6479637964    - `mount_path: optional string or null`79657966      Mount path in the container. Defaults to `/workspace/<repo-name>`.79677968  - `BetaManagedAgentsFileResourceConfig object`79697970    A file mounted into each session's container.79717972    - `type: "file"`79737974    - `file_id: string`79757976      ID of a previously uploaded file.79777978    - `mount_path: optional string or null`79797980      Mount path in the container. Defaults to `/mnt/session/uploads/<file_id>`.79817982  - `BetaManagedAgentsMemoryStoreResourceConfig object`79837984    A memory store attached to each session created from this deployment.79857986    - `type: "memory_store"`79877988    - `memory_store_id: string`79897990      The memory store ID (memstore_...). Must belong to the caller's organization and workspace.79917992    - `access: optional "read_write" or "read_only" or null`79937994      Access mode for an attached memory store.79957996      - `"read_write"`79977998      - `"read_only"`79998000    - `instructions: optional string or null`80018002      Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.80038004### Beta Managed Agents Session Resource Not Found Deployment Paused Reason Error80058006- `BetaManagedAgentsSessionResourceNotFoundDeploymentPausedReasonError object`80078008  A referenced resource no longer exists and its kind was not reported.80098010  - `type: "session_resource_not_found_error"`80118012### Beta Managed Agents Skill Not Found Deployment Paused Reason Error80138014- `BetaManagedAgentsSkillNotFoundDeploymentPausedReasonError object`80158016  A skill referenced by the deployment's agent no longer exists.80178018  - `type: "skill_not_found_error"`80198020### Beta Managed Agents Unknown Deployment Paused Reason Error80218022- `BetaManagedAgentsUnknownDeploymentPausedReasonError object`80238024  An unrecognized error auto-paused the deployment. A fallback variant; matches a run whose `error.type` is `unknown_error`.80258026  - `type: "unknown_error"`80278028### Beta Managed Agents Vault Archived Deployment Paused Reason Error80298030- `BetaManagedAgentsVaultArchivedDeploymentPausedReasonError object`80318032  A vault referenced by the deployment is archived.80338034  - `type: "vault_archived_error"`80358036### Beta Managed Agents Vault Not Found Deployment Paused Reason Error80378038- `BetaManagedAgentsVaultNotFoundDeploymentPausedReasonError object`80398040  A vault referenced by the deployment no longer exists.80418042  - `type: "vault_not_found_error"`80438044### Beta Managed Agents Workspace Archived Deployment Paused Reason Error80458046- `BetaManagedAgentsWorkspaceArchivedDeploymentPausedReasonError object`80478048  The deployment's workspace was archived.80498050  - `type: "workspace_archived_error"`8051