---
title: "Request a new cloud deployment"
method: POST
path: "/v1/deployments"
tags: ["Deployments"]
---

# Request a new cloud deployment

`POST /v1/deployments`

## Request

- Base URL: `https://api.algenta.ai`
- URL: `https://api.algenta.ai/v1/deployments`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Provision an isolated engine deployment on your chosen cloud provider and region. Returns 202 Accepted immediately — provisioning is async (typically 3-5 minutes). Poll GET /v1/deployments to check status. When status=active, all API calls are automatically routed to your isolated deployment. Requires owner role.

## Request body

- DeploymentCreate
  - `provider` string: Cloud provider: algenta_shared, aws, azure, gcp
  - `region` string: Cloud region identifier. Use /v1/deployments/regions to list options.
  - `config` object, nullable: Optional provider-specific configuration. Supported keys: instance_size (e.g. 'small'|'medium'|'large'), storage_gb, max_concurrent_runs, auto_scale_max.
  - `billing_markup_pct` number: Pass-through cost markup percentage. Default: 20%.

## Response `202`

Successful Response

- DeploymentResponse
  - `deployment_id` string, required
  - `org_id` string, required
  - `provider` string, required
  - `region` string, required
  - `status` string, required
  - `endpoint_url` string, nullable, required
  - `cost_usd_month` number, required
  - `billable_cost_usd_month` number, required
  - `billing_markup_pct` number, required
  - `created_at` string, required
  - `provisioned_at` string, nullable, required
  - `error_message` string, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/codna/apis/algenta-api.md) · [All operations](https://skmtc.dev/codna/apis/algenta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/codna/apis/algenta-api/revisions/35d30f84a5df?raw)