API Reference

Create and initialize a new tenant workspace with Vault-backed storage.

Create an organization under the current workspace.

Delete the current workspace and all associated resources.

Store AWS access key and secret in Vault for use during provisioning.

Store Azure service principal credentials in Vault.

Store GCP service account JSON key in Vault.

Generate and store a developer API token for authentication.

Retrieve existing API token from Vault by name.

List all stored credentials for the current workspace.

Store OpenAI API key for AI-assisted operations.

Store Anthropic/Claude API credentials in Vault.

List all stored AI provider credentials (OpenAI, Anthropic, Gemini, DeepSeek, Qwen, HuggingFace, Azure OpenAI).

Provision a core VM instance (InstaNodeBox) using the default workspace credentials.

Provision a multi-cloud tenant VM on AWS, GCP, or Azure with full Terraform state management.

Get the current status, IP addresses, and health of a provisioned VM instance.

Perform lifecycle actions (start, stop, restart, reboot) on a provisioned VM.

Provision a multi-cloud Docker environment on a target VM or cloud instance.

Test Docker daemon connectivity on the target host before deployment.

Open a WebSocket connection to stream real-time container logs.

Get the current runtime status of a Docker container.

Execute container actions: start, stop, restart, pause, unpause.

Pull and deploy a container from a registry to a specified VM.

Provision an EKS, GKE, or AKS Kubernetes cluster with Terraform.

List all Kubernetes clusters provisioned in the current tenant workspace.

Get full details for a specific cluster: endpoint, version, node count.

List all pods across all namespaces in the cluster.

List all Kubernetes Deployments in the cluster.

List all Kubernetes Services (ClusterIP, NodePort, LoadBalancer).

Apply a raw Kubernetes YAML manifest to the cluster.

Import an existing Kubernetes cluster by providing a kubeconfig.

Open a WebSocket terminal session into a running pod (kubectl exec).

Provision a managed cloud database (RDS, Cloud SQL, Azure DB) on AWS, GCP, or Azure.

Check the health and status of a cloud-managed database.

Provision a self-hosted MetalDB (PostgreSQL/MySQL) on a bare-metal or VM target.

Verify TCP/SQL connectivity to provisioned MetalDB.

Execute a SQL query on a running MetalDB instance and return results.

Trigger an on-demand backup of a MetalDB instance.

Configure database replication (primary → replica) for HA.

Provision an S3 bucket (AWS), GCS bucket (GCP), or Azure Blob container.

Get metadata, size, and object count for an existing S3 bucket.

Upload a file to a provisioned bucket from a URL or multipart form.

List all objects in a bucket with optional prefix filter.

Generate a pre-signed URL valid for a limited time to download an object.

Provision a VPC with subnets, route tables, and internet gateways on any cloud.

Provision security groups, IAM roles, and firewall rules.

Install and configure an OpenVPN server on a target VM.

Install and configure a WireGuard VPN server on a target VM.

Add a new VPN client certificate/config and trigger automatic distribution.

Install a Let's Encrypt or custom SSL certificate on a target host or load balancer.

Provision a cloud-managed SSL certificate (ACM/GCP Certificate Manager).

Trigger a GitHub Actions workflow run with custom inputs.

Deploy a static site (HTML/CSS/JS) to S3 + CloudFront or Netlify-compatible hosting.

Deploy a FastAPI application to a VM with automatic process management (Gunicorn/Uvicorn).

Build and deploy a React/Next.js application to a target server.

Deploy a serverless function (AWS Lambda, GCP Cloud Functions, or Azure Functions).

Provision an AWS CloudFront CDN distribution with custom origins and behaviors.

Provision an AI agent workspace on cloud infrastructure.

Deploy a new AI agent with resource limits and environment variables.

List all agent deployments and their current status.

Stream logs from a running agent deployment.

Scale an agent deployment horizontally (replicas).

Provision a Model Context Protocol (MCP) orchestration instance.

Deploy an AI/LLM model inference endpoint on cloud infrastructure.

Create a snapshot backup of infrastructure resources.

List all backups for the current tenant.

Restore a resource from an existing backup snapshot.

Generate a migration plan for moving resources between regions or providers.

Execute an approved migration plan.

Batch synchronize discovered cloud resources into VxCloud state.

Retrieve cost breakdown across all connected cloud providers for the current billing period.

Get AI-powered cost optimization recommendations for your cloud spend.

Start a stopped Docker container by name on the target VM. JSON body.

Stop a running Docker container by name on the target VM. JSON body.

Stop and remove a Docker container by name on the target VM. Destructive — the CLI requires --yes before sending. JSON body.

Inspect a Docker container by name (or list all if `service_name` is empty). Returns id, image, status, port mapping. JSON body.

Run a whitelisted maintenance action on a remote VM via SSH. Multipart form. The `action` field must match one of the whitelist keys; `target` (optional) is substituted into commands that take an argument.