Repository Public
1---2title: Create Deployment3url: https://platform.claude.com/docs/en/api/beta/deployments/create4---56# Create Deployment78**POST** `/v1/deployments`910Create Deployment1112## Headers1314- `"anthropic-beta": optional array of AnthropicBeta`1516 Optional header to specify the beta version(s) you want to use.1718 - `string`1920 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`2122 - `"message-batches-2024-09-24"`2324 - `"prompt-caching-2024-07-31"`2526 - `"computer-use-2024-10-22"`2728 - `"computer-use-2025-01-24"`2930 - `"pdfs-2024-09-25"`3132 - `"token-counting-2024-11-01"`3334 - `"token-efficient-tools-2025-02-19"`3536 - `"output-128k-2025-02-19"`3738 - `"files-api-2025-04-14"`3940 - `"mcp-client-2025-04-04"`4142 - `"mcp-client-2025-11-20"`4344 - `"dev-full-thinking-2025-05-14"`4546 - `"interleaved-thinking-2025-05-14"`4748 - `"code-execution-2025-05-22"`4950 - `"extended-cache-ttl-2025-04-11"`5152 - `"context-1m-2025-08-07"`5354 - `"context-management-2025-06-27"`5556 - `"model-context-window-exceeded-2025-08-26"`5758 - `"skills-2025-10-02"`5960 - `"fast-mode-2026-02-01"`6162 - `"output-300k-2026-03-24"`6364 - `"user-profiles-2026-03-24"`6566 - `"user-profiles-2026-08-18"`6768 - `"user-profiles-2026-09-04"`6970 - `"advisor-tool-2026-03-01"`7172 - `"managed-agents-2026-04-01"`7374 - `"cache-diagnosis-2026-04-07"`7576 - `"dreaming-2026-04-21"`7778 - `"thinking-token-count-2026-05-13"`7980 - `"server-side-fallback-2026-06-01"`8182 - `"server-side-fallback-2026-07-01"`8384 - `"fallback-credit-2026-06-01"`8586 - `"fallback-credit-2026-07-01"`8788 - `"agent-memory-2026-07-22"`8990 - `"mid-conversation-tool-changes-2026-07-01"`9192 - `"compact-2026-01-12"`9394 - `"computer-use-2025-11-24"`9596 - `"mcp-tunnels-2026-06-22"`9798 - `"structured-outputs-2025-11-13"`99100 - `"task-budgets-2026-03-13"`101102 - `"thinking-display-updates-2026-08-18"`103104 - `"ce-user-management-2026-07-13"`105106 - `"mid-conversation-output-config-2026-07-01"`107108 - `"thinking-binding-controls-2026-08-01"`109110 - `"mid-conversation-system-clear-at-2026-08-21"`111112 - `"compact-2026-09-04"`113114- `"anthropic-workspace-id": optional string`115116## Body parameters117118- `agent: string or BetaManagedAgentsAgentParams`119120 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.121122 - `string`123124 - `BetaManagedAgentsAgentParams object`125126 Specification for an Agent. Provide a specific `version` or use the short-form `agent="agent_id"` for the most recent version127128 - `type: "agent"`129130 - `id: string`131132 The `agent` ID.133134 minLength: 1, maxLength: 128135136 - `version: optional number`137138 The specific `agent` version to use. Omit to use the latest version. Must be at least 1 if specified.139140 format: int32141142- `environment_id: string`143144 ID of the `environment` defining the container configuration for sessions created from this deployment.145146 minLength: 1, maxLength: 128147148- `initial_events: array of BetaManagedAgentsDeploymentInitialEventParams`149150 Events to send to each session immediately after creation. At least 1, maximum 50.151152 - `BetaManagedAgentsUserMessageEventParams object`153154 Parameters for sending a user message to the session.155156 - `type: "user.message"`157158 - `content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsRedactedBlock`159160 Array of content blocks for the user message.161162 - `BetaManagedAgentsTextBlock object`163164 Regular text content.165166 - `type: "text"`167168 - `text: string`169170 The text content.171172 minLength: 1173174 - `BetaManagedAgentsImageBlock object`175176 Image content specified directly as base64 data or as a reference via a URL.177178 - `type: "image"`179180 - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`181182 Union type for image source variants.183184 - `BetaManagedAgentsBase64ImageSource object`185186 Base64-encoded image data.187188 - `type: "base64"`189190 - `data: string`191192 Base64-encoded image data.193194 minLength: 1195196 - `media_type: string`197198 MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").199200 minLength: 1201202 - `BetaManagedAgentsURLImageSource object`203204 Image referenced by URL.205206 - `type: "url"`207208 - `url: string`209210 URL of the image to fetch.211212 minLength: 1213214 - `BetaManagedAgentsFileImageSource object`215216 Image referenced by file ID.217218 - `type: "file"`219220 - `file_id: string`221222 ID of a previously uploaded file.223224 minLength: 1225226 - `BetaManagedAgentsDocumentBlock object`227228 Document content, either specified directly as base64 data, as text, or as a reference via a URL.229230 - `type: "document"`231232 - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`233234 Union type for document source variants.235236 - `BetaManagedAgentsBase64DocumentSource object`237238 Base64-encoded document data.239240 - `type: "base64"`241242 - `data: string`243244 Base64-encoded document data.245246 minLength: 1247248 - `media_type: string`249250 MIME type of the document (e.g., "application/pdf").251252 minLength: 1253254 - `BetaManagedAgentsPlainTextDocumentSource object`255256 Plain text document content.257258 - `type: "text"`259260 - `data: string`261262 The plain text content.263264 minLength: 1265266 - `media_type: "text/plain"`267268 MIME type of the text content. Must be "text/plain".269270 - `BetaManagedAgentsURLDocumentSource object`271272 Document referenced by URL.273274 - `type: "url"`275276 - `url: string`277278 URL of the document to fetch.279280 minLength: 1281282 - `BetaManagedAgentsFileDocumentSource object`283284 Document referenced by file ID.285286 - `type: "file"`287288 - `file_id: string`289290 ID of a previously uploaded file.291292 minLength: 1293294 - `context: optional string or null`295296 Additional context about the document for the model.297298 - `title: optional string or null`299300 The title of the document.301302 - `BetaManagedAgentsRedactedBlock object`303304 Placeholder for content withheld by Anthropic model policy.305306 - `type: "redacted"`307308 - `BetaManagedAgentsUserDefineOutcomeEventParams object`309310 Parameters for defining an outcome the agent should work toward. The agent begins work on receipt.311312 - `type: "user.define_outcome"`313314 - `description: string`315316 What the agent should produce. This is the task specification.317318 - `rubric: BetaManagedAgentsFileRubricParams or BetaManagedAgentsTextRubricParams`319320 Rubric for grading the quality of an outcome.321322 - `BetaManagedAgentsFileRubricParams object`323324 Rubric referenced by a file uploaded via the Files API.325326 - `type: "file"`327328 - `file_id: string`329330 ID of the rubric file.331332 - `BetaManagedAgentsTextRubricParams object`333334 Rubric content provided inline as text.335336 - `type: "text"`337338 - `content: string`339340 Rubric content. Plain text or markdown — the grader treats it as freeform text. Maximum 262144 characters.341342 maxLength: 262144343344 - `max_iterations: optional number or null`345346 Eval→revision cycles before giving up. Default 3, max 20.347348 format: int32349350 - `BetaManagedAgentsSystemMessageEventParams object`351352 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.353354 - `type: "system.message"`355356 - `content: array of BetaManagedAgentsSystemContentBlock`357358 System content blocks to append. Text-only.359360 - `type: "text"`361362 - `text: string`363364 The text content.365366 minLength: 1367368- `name: string`369370 Human-readable name for the deployment.371372 minLength: 1, maxLength: 256373374- `budget: optional BetaManagedAgentsBudgetLimit or null`375376 A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.377378 - `type: "limit"`379380 - `max_list_cost: BetaMonetaryAmount`381382 A monetary amount in a specific currency.383384 - `amount: string`385386 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.387388 - `currency: BetaCurrency`389390 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.391392- `description: optional string or null`393394 Description of what the deployment does.395396 maxLength: 2048397398- `metadata: optional map[string]`399400 Arbitrary key-value metadata. Maximum 16 pairs, keys up to 64 chars, values up to 512 chars.401402- `resources: optional array of BetaManagedAgentsGitHubRepositoryResourceParams or BetaManagedAgentsFileResourceParams or BetaManagedAgentsMemoryStoreResourceParam`403404 Resources (e.g. repositories, files) to mount into each session's container. Maximum 500.405406 - `BetaManagedAgentsGitHubRepositoryResourceParams object`407408 Mount a GitHub repository into the session's container.409410 - `type: "github_repository"`411412 - `url: string`413414 Github URL of the repository415416 minLength: 1, maxLength: 2048417418 - `authorization_token: optional string`419420 GitHub authorization token used to clone the repository. Required for private repositories; optional for public ones.421422 minLength: 1, maxLength: 4096423424 - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`425426 Branch or commit to check out. Defaults to the repository's default branch.427428 - `BetaManagedAgentsBranchCheckout object`429430 - `type: "branch"`431432 - `name: string`433434 Branch name to check out.435436 minLength: 1, maxLength: 255437438 - `BetaManagedAgentsCommitCheckout object`439440 - `type: "commit"`441442 - `sha: string`443444 Full commit SHA to check out.445446 minLength: 7, maxLength: 64447448 - `mount_path: optional string or null`449450 Mount path in the container. Defaults to `/workspace/<repo-name>`.451452 minLength: 1, maxLength: 4096453454 - `BetaManagedAgentsFileResourceParams object`455456 Mount a file uploaded via the Files API into the session.457458 - `type: "file"`459460 - `file_id: string`461462 ID of a previously uploaded file.463464 minLength: 1, maxLength: 128465466 - `mount_path: optional string or null`467468 Mount path in the container. Defaults to `/mnt/session/uploads/<file_id>`.469470 minLength: 1, maxLength: 4096471472 - `BetaManagedAgentsMemoryStoreResourceParam object`473474 Parameters for attaching a memory store to an agent session.475476 - `type: "memory_store"`477478 - `memory_store_id: string`479480 The memory store ID (memstore_...). Must belong to the caller's organization and workspace.481482 - `access: optional "read_write" or "read_only" or null`483484 Access mode for an attached memory store.485486 - `"read_write"`487488 - `"read_only"`489490 - `instructions: optional string or null`491492 Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.493494 maxLength: 4096495496- `schedule: optional BetaManagedAgentsScheduleParams or null`497498 5-field POSIX cron schedule. Literal wall-clock matching in the configured timezone.499500 - `type: "cron"`501502 - `expression: string`503504 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).505506 minLength: 1, maxLength: 256507508 - `timezone: string`509510 Required. IANA timezone identifier (e.g., "America/Los_Angeles", "UTC"). Validated against the IANA timezone database.511512 minLength: 1513514- `vault_ids: optional array of string`515516 Vault IDs for stored credentials the agent can use during sessions created from this deployment. Maximum 50.517518## Returns519520- `BetaManagedAgentsDeployment object`521522 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.523524 - `type: "deployment"`525526 - `id: string`527528 Unique identifier for this deployment.529530 - `agent: BetaManagedAgentsAgentReference`531532 A resolved agent reference with a concrete version.533534 - `type: "agent"`535536 - `id: string`537538 - `version: number`539540 format: int32541542 - `archived_at: string or null`543544 A timestamp in RFC 3339 format545546 format: date-time547548 - `created_at: string`549550 A timestamp in RFC 3339 format551552 format: date-time553554 - `description: string or null`555556 Description of what the deployment does.557558 - `environment_id: string`559560 ID of the `environment` where sessions run.561562 - `initial_events: array of BetaManagedAgentsDeploymentInitialEvent`563564 Events sent to each session immediately after creation.565566 - `BetaManagedAgentsDeploymentUserMessageEvent object`567568 A user message sent to the session.569570 - `type: "user.message"`571572 - `content: array of BetaManagedAgentsTextBlock or BetaManagedAgentsImageBlock or BetaManagedAgentsDocumentBlock or BetaManagedAgentsRedactedBlock`573574 Array of content blocks for the user message.575576 - `BetaManagedAgentsTextBlock object`577578 Regular text content.579580 - `type: "text"`581582 - `text: string`583584 The text content.585586 minLength: 1587588 - `BetaManagedAgentsImageBlock object`589590 Image content specified directly as base64 data or as a reference via a URL.591592 - `type: "image"`593594 - `source: BetaManagedAgentsBase64ImageSource or BetaManagedAgentsURLImageSource or BetaManagedAgentsFileImageSource`595596 Union type for image source variants.597598 - `BetaManagedAgentsBase64ImageSource object`599600 Base64-encoded image data.601602 - `type: "base64"`603604 - `data: string`605606 Base64-encoded image data.607608 minLength: 1609610 - `media_type: string`611612 MIME type of the image (e.g., "image/png", "image/jpeg", "image/gif", "image/webp").613614 minLength: 1615616 - `BetaManagedAgentsURLImageSource object`617618 Image referenced by URL.619620 - `type: "url"`621622 - `url: string`623624 URL of the image to fetch.625626 minLength: 1627628 - `BetaManagedAgentsFileImageSource object`629630 Image referenced by file ID.631632 - `type: "file"`633634 - `file_id: string`635636 ID of a previously uploaded file.637638 minLength: 1639640 - `BetaManagedAgentsDocumentBlock object`641642 Document content, either specified directly as base64 data, as text, or as a reference via a URL.643644 - `type: "document"`645646 - `source: BetaManagedAgentsBase64DocumentSource or BetaManagedAgentsPlainTextDocumentSource or BetaManagedAgentsURLDocumentSource or BetaManagedAgentsFileDocumentSource`647648 Union type for document source variants.649650 - `BetaManagedAgentsBase64DocumentSource object`651652 Base64-encoded document data.653654 - `type: "base64"`655656 - `data: string`657658 Base64-encoded document data.659660 minLength: 1661662 - `media_type: string`663664 MIME type of the document (e.g., "application/pdf").665666 minLength: 1667668 - `BetaManagedAgentsPlainTextDocumentSource object`669670 Plain text document content.671672 - `type: "text"`673674 - `data: string`675676 The plain text content.677678 minLength: 1679680 - `media_type: "text/plain"`681682 MIME type of the text content. Must be "text/plain".683684 - `BetaManagedAgentsURLDocumentSource object`685686 Document referenced by URL.687688 - `type: "url"`689690 - `url: string`691692 URL of the document to fetch.693694 minLength: 1695696 - `BetaManagedAgentsFileDocumentSource object`697698 Document referenced by file ID.699700 - `type: "file"`701702 - `file_id: string`703704 ID of a previously uploaded file.705706 minLength: 1707708 - `context: optional string or null`709710 Additional context about the document for the model.711712 - `title: optional string or null`713714 The title of the document.715716 - `BetaManagedAgentsRedactedBlock object`717718 Placeholder for content withheld by Anthropic model policy.719720 - `type: "redacted"`721722 - `BetaManagedAgentsDeploymentUserDefineOutcomeEvent object`723724 An outcome the agent should work toward. The agent begins work on receipt.725726 - `type: "user.define_outcome"`727728 - `description: string`729730 What the agent should produce. This is the task specification.731732 - `rubric: BetaManagedAgentsFileRubric or BetaManagedAgentsTextRubric`733734 Rubric for grading the quality of an outcome.735736 - `BetaManagedAgentsFileRubric object`737738 Rubric referenced by a file uploaded via the Files API.739740 - `type: "file"`741742 - `file_id: string`743744 ID of the rubric file.745746 - `BetaManagedAgentsTextRubric object`747748 Rubric content provided inline as text.749750 - `type: "text"`751752 - `content: string`753754 Rubric content. Plain text or markdown — the grader treats it as freeform text.755756 - `max_iterations: optional number or null`757758 Eval→revision cycles before giving up. Default 3, max 20.759760 format: int32761762 - `BetaManagedAgentsDeploymentSystemMessageEvent object`763764 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.765766 - `type: "system.message"`767768 - `content: array of BetaManagedAgentsSystemContentBlock`769770 System content blocks to append. Text-only.771772 - `type: "text"`773774 - `text: string`775776 The text content.777778 minLength: 1779780 - `metadata: map[string]`781782 Arbitrary key-value metadata. Maximum 16 pairs.783784 - `name: string`785786 Human-readable name.787788 - `paused_reason: BetaManagedAgentsDeploymentPausedReason or null`789790 Why a deployment is paused. Non-null exactly when `status` is `paused`.791792 - `BetaManagedAgentsManualDeploymentPausedReason object`793794 The caller invoked the pause endpoint on the deployment.795796 - `type: "manual"`797798 - `BetaManagedAgentsErrorDeploymentPausedReason object`799800 A scheduled fire recorded a failed run whose error auto-pauses the deployment.801802 - `type: "error"`803804 - `error: BetaManagedAgentsDeploymentPausedReasonError`805806 The error that triggered an auto-pause. Matches the failed run's `error.type`.807808 - `BetaManagedAgentsEnvironmentArchivedDeploymentPausedReasonError object`809810 The deployment's environment was archived.811812 - `type: "environment_archived_error"`813814 - `BetaManagedAgentsAgentArchivedDeploymentPausedReasonError object`815816 The deployment's agent was archived.817818 - `type: "agent_archived_error"`819820 - `BetaManagedAgentsEnvironmentNotFoundDeploymentPausedReasonError object`821822 The deployment's environment no longer exists.823824 - `type: "environment_not_found_error"`825826 - `BetaManagedAgentsVaultNotFoundDeploymentPausedReasonError object`827828 A vault referenced by the deployment no longer exists.829830 - `type: "vault_not_found_error"`831832 - `BetaManagedAgentsFileNotFoundDeploymentPausedReasonError object`833834 A file resource referenced by the deployment no longer exists.835836 - `type: "file_not_found_error"`837838 - `BetaManagedAgentsSessionResourceNotFoundDeploymentPausedReasonError object`839840 A referenced resource no longer exists and its kind was not reported.841842 - `type: "session_resource_not_found_error"`843844 - `BetaManagedAgentsWorkspaceArchivedDeploymentPausedReasonError object`845846 The deployment's workspace was archived.847848 - `type: "workspace_archived_error"`849850 - `BetaManagedAgentsOrganizationDisabledDeploymentPausedReasonError object`851852 The deployment's organization is disabled.853854 - `type: "organization_disabled_error"`855856 - `BetaManagedAgentsMemoryStoreArchivedDeploymentPausedReasonError object`857858 A memory store referenced by the deployment is archived.859860 - `type: "memory_store_archived_error"`861862 - `BetaManagedAgentsSkillNotFoundDeploymentPausedReasonError object`863864 A skill referenced by the deployment's agent no longer exists.865866 - `type: "skill_not_found_error"`867868 - `BetaManagedAgentsVaultArchivedDeploymentPausedReasonError object`869870 A vault referenced by the deployment is archived.871872 - `type: "vault_archived_error"`873874 - `BetaManagedAgentsUnknownDeploymentPausedReasonError object`875876 An unrecognized error auto-paused the deployment. A fallback variant; matches a run whose `error.type` is `unknown_error`.877878 - `type: "unknown_error"`879880 - `BetaManagedAgentsSelfHostedResourcesUnsupportedDeploymentPausedReasonError object`881882 The deployment configures resources, but its environment is self-hosted and cannot mount them.883884 - `type: "self_hosted_resources_unsupported_error"`885886 - `BetaManagedAgentsMCPEgressBlockedDeploymentPausedReasonError object`887888 An MCP server host used by the deployment's agent is blocked by the environment's network policy.889890 - `type: "mcp_egress_blocked_error"`891892 - `resources: array of BetaManagedAgentsSessionResourceConfig`893894 Resources attached to sessions created from this deployment. Echoes the input minus write-only credentials.895896 - `BetaManagedAgentsGitHubRepositoryResourceConfig object`897898 A GitHub repository mounted into each session's container. The authorization token is write-only and never returned.899900 - `type: "github_repository"`901902 - `url: string`903904 Github URL of the repository905906 - `checkout: optional BetaManagedAgentsBranchCheckout or BetaManagedAgentsCommitCheckout or null`907908 Branch or commit to check out. Defaults to the repository's default branch.909910 - `BetaManagedAgentsBranchCheckout object`911912 - `type: "branch"`913914 - `name: string`915916 Branch name to check out.917918 minLength: 1, maxLength: 255919920 - `BetaManagedAgentsCommitCheckout object`921922 - `type: "commit"`923924 - `sha: string`925926 Full commit SHA to check out.927928 minLength: 7, maxLength: 64929930 - `mount_path: optional string or null`931932 Mount path in the container. Defaults to `/workspace/<repo-name>`.933934 - `BetaManagedAgentsFileResourceConfig object`935936 A file mounted into each session's container.937938 - `type: "file"`939940 - `file_id: string`941942 ID of a previously uploaded file.943944 - `mount_path: optional string or null`945946 Mount path in the container. Defaults to `/mnt/session/uploads/<file_id>`.947948 - `BetaManagedAgentsMemoryStoreResourceConfig object`949950 A memory store attached to each session created from this deployment.951952 - `type: "memory_store"`953954 - `memory_store_id: string`955956 The memory store ID (memstore_...). Must belong to the caller's organization and workspace.957958 - `access: optional "read_write" or "read_only" or null`959960 Access mode for an attached memory store.961962 - `"read_write"`963964 - `"read_only"`965966 - `instructions: optional string or null`967968 Per-attachment guidance for the agent on how to use this store. Rendered into the memory section of the system prompt. Max 4096 chars.969970 - `schedule: BetaManagedAgentsSchedule or null`971972 5-field POSIX cron schedule with computed runtime timestamps.973974 - `type: "cron"`975976 - `expression: string`977978 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).979980 minLength: 1, maxLength: 256981982 - `timezone: string`983984 IANA timezone identifier (e.g., "America/Los_Angeles", "UTC").985986 minLength: 1987988 - `last_run_at: optional string or null`989990 A timestamp in RFC 3339 format991992 format: date-time993994 - `upcoming_runs_at: optional array of string`995996 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.997998 - `status: BetaManagedAgentsDeploymentStatus`9991000 Lifecycle status of a deployment.10011002 - `"active"`10031004 - `"paused"`10051006 - `updated_at: string`10071008 A timestamp in RFC 3339 format10091010 format: date-time10111012 - `vault_ids: array of string`10131014 Vault IDs supplying stored credentials for sessions created from this deployment.10151016 - `budget: optional BetaManagedAgentsBudgetLimit or null`10171018 A hard spend ceiling. The session stops issuing new model requests once the tracked list cost reaches `max_list_cost`.10191020 - `type: "limit"`10211022 - `max_list_cost: BetaMonetaryAmount`10231024 A monetary amount in a specific currency.10251026 - `amount: string`10271028 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.10291030 - `currency: BetaCurrency`10311032 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.10331034## Example10351036```bash1037curl https://api.anthropic.com/v1/deployments \1038 -H 'Content-Type: application/json' \1039 -H 'anthropic-version: 2023-06-01' \1040 -H 'anthropic-beta: managed-agents-2026-04-01' \1041 -H "X-Api-Key: $ANTHROPIC_API_KEY" \1042 -d '{1043 "agent": "string",1044 "environment_id": "x",1045 "initial_events": [1046 {1047 "content": [1048 {1049 "text": "Where is my order #1234?",1050 "type": "text"1051 }1052 ],1053 "type": "user.message"1054 }1055 ],1056 "name": "x"1057 }'1058```10591060### Response (200)10611062```json1063{1064 "id": "depl_011CZkZcDH3vPqd7xnEfwTai",1065 "agent": {1066 "id": "agent_011CZkYpogX7uDKUyvBTophP",1067 "type": "agent",1068 "version": 11069 },1070 "archived_at": null,1071 "created_at": "2026-03-15T10:00:00Z",1072 "description": "Compiles yesterday's orders into a report every weekday morning.",1073 "environment_id": "env_011CZkZ9X2dpNyB7HsEFoRfW",1074 "initial_events": [1075 {1076 "content": [1077 {1078 "text": "Compile yesterday's orders into report.md.",1079 "type": "text"1080 }1081 ],1082 "type": "user.message"1083 }1084 ],1085 "metadata": {},1086 "name": "Daily order report",1087 "paused_reason": {1088 "type": "manual"1089 },1090 "resources": [1091 {1092 "type": "github_repository",1093 "url": "url",1094 "checkout": {1095 "name": "main",1096 "type": "branch"1097 },1098 "mount_path": "mount_path"1099 }1100 ],1101 "schedule": {1102 "expression": "0 9 * * 1-5",1103 "timezone": "America/Los_Angeles",1104 "type": "cron",1105 "last_run_at": "2026-03-16T16:00:09Z",1106 "upcoming_runs_at": [1107 "2026-03-17T16:00:00Z",1108 "2026-03-18T16:00:00Z"1109 ]1110 },1111 "status": "active",1112 "type": "deployment",1113 "updated_at": "2026-03-15T10:00:00Z",1114 "vault_ids": [1115 "vlt_011CZkZDLs7fYzm1hXNPeRjv"1116 ],1117 "budget": {1118 "max_list_cost": {1119 "amount": "2500",1120 "currency": "USD"1121 },1122 "type": "limit"1123 }1124}1125```1126