WarpBuild LogoWarpBuild Docs
Cloud

POST /cloud/integrations

Creates a new cloud integration to connect WarpBuild to your cloud provider account. This enables WarpBuild to provision runner infrastructure in your cloud environment. Supported cloud providers: - **AWS**: Connect via IAM role with cross-account access - **GCP**: Connect via service account with Workload Identity Federation - **Azure**: Connect via service principal with federated credentials

POST
/cloud/integrations
Authorization<token>

In: header

Request Body

application/json

Create new cloud integration body

cloud_entity_id?string
cloud_organization_id?string
cloud_provider*string
connection_mode*string
Value in"runner-manager"
integration_type*string
Value in"cloud-entity-keyless" | "cloud-organization-keyless" | "cloud-entity-key"

Response Body

application/json

application/json

application/json

curl -X POST "https://api.warpbuild.com/api/v1/cloud/integrations" \  -H "Content-Type: application/json" \  -d '{    "cloud_provider": "string",    "connection_mode": "runner-manager",    "integration_type": "cloud-entity-keyless"  }'
{
  "actions": [
    {
      "markdown": "string",
      "message": "string",
      "name": "redirect",
      "redirect_url": "string"
    }
  ],
  "integration": {
    "cloud_entity_id": "string",
    "cloud_entity_name": "string",
    "cloud_organization_id": "string",
    "cloud_organization_name": "string",
    "cloud_provider": "aws",
    "connection_details": {
      "aws": {
        "region": "string",
        "stack_id": "string"
      },
      "azure": {},
      "gcp": {
        "service_account_email": "string"
      }
    },
    "connection_mode": "string",
    "created_at": "string",
    "id": "string",
    "integration_type": "cloud-entity-keyless",
    "latest_version": "string",
    "organization_id": "string",
    "status": "connected",
    "updated_at": "string",
    "version": "string"
  }
}
{
  "code": "string",
  "description": "string",
  "message": "string",
  "sub_code": "string",
  "sub_message": "string"
}
{
  "code": "string",
  "description": "string",
  "message": "string",
  "sub_code": "string",
  "sub_message": "string"
}