Deployments

Request a new cloud deployment

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.

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

Request body

providerstring

Cloud provider: algenta_shared, aws, azure, gcp

regionstring

Cloud region identifier. Use /v1/deployments/regions to list options.

configobject nullable

Optional provider-specific configuration. Supported keys: instance_size (e.g. 'small'|'medium'|'large'), storage_gb, max_concurrent_runs, auto_scale_max.

billing_markup_pctnumber

Pass-through cost markup percentage. Default: 20%.

Response

Successful Response

deployment_idstring required
org_idstring required
providerstring required
regionstring required
statusstring required
endpoint_urlstring nullable required
cost_usd_monthnumber required
billable_cost_usd_monthnumber required
billing_markup_pctnumber required
created_atstring required
provisioned_atstring nullable required
error_messagestring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.