📌CLI & API Reference

$ cnx auth login
Opening browser for authentication...
✓ Authenticated as sarah@cloudnexus.io
✓ Default project: production-main

$ cnx auth login --api-key cnx_live_sk_4f8a2c...
✓ API key validated
✓ Configured profile: default

# List all servers
$ cnx servers list
ID              NAME              REGION     STATUS   CPU   MEMORY
srv_a8f3k2m   web-prod-01       us-east    running  2     8GB
srv_b7g4j1n   api-prod-01       eu-west    running  4     16GB
srv_c6h5i0o   db-primary        us-east    running  8     32GB

# Create a new server
$ cnx servers create --name web-prod-02 --plan professional --region us-east
✓ Server created: srv_d9i6l2p
  IP: 203.0.113.42
  SSH: ssh root@203.0.113.42

# Scale a server
$ cnx servers resize srv_a8f3k2m --plan enterprise
✓ Server resizing in progress...
✓ Server resized to enterprise plan

# Delete a server
$ cnx servers delete srv_a8f3k2m --confirm
✓ Server srv_a8f3k2m deleted

# Create a PostgreSQL database
$ cnx databases create --name app-db --engine postgresql --version 16
✓ Database created: db_x3y7z1a
  Connection: postgresql://cnx:***@db-x3y7z1a.cloudnexus.io:5432/app-db

# List databases
$ cnx databases list --json
[{"id":"db_x3y7z1a","name":"app-db","engine":"postgresql","status":"active"},...]

# Create a read replica
$ cnx databases replica create db_x3y7z1a --region eu-west
✓ Read replica created: db_w2v6u9b

# Deploy from Git repository
$ cnx deploy git --repo github.com/your-org/your-app --branch main
✓ Building application...
✓ Deploying to cloudnexus.app
✓ Deployment complete: https://your-app.cloudnexus.app

# Deploy a Docker image
$ cnx deploy docker --image your-app:latest --env NODE_ENV=production
✓ Container deployed successfully

# View deployment logs
$ cnx deploy logs --follow dep_abc123
2025-01-15T10:30:00Z [INFO] Application started on port 3000

{
  "profile": "default",
  "project": "production-main",
  "api_key": "cnx_live_sk_****",
  "output": "human",
  "auto_update": true,
  "telemetry": true,
  "default_region": "us-east"
}

# List environments
$ cnx environments list
NAME          REGION       STATUS     SERVERS
development   us-east      active     3
staging       eu-west      active     5
production    multi        active     12

# Switch to an environment
$ cnx environments use production
✓ Switched to: production

# Set environment variables
$ cnx environments vars set production --var DB_URL=postgresql://...
✓ Variable DB_URL set for production

# List environment variables
$ cnx environments vars list production
DB_URL        postgresql://***@...
REDIS_URL     redis://***@...
API_KEY       cnx_live_sk_****

# cURL Example
$ curl -X GET https://api.cloudnexus.io/v3/servers \
  -H "Authorization: Bearer cnx_live_sk_4f8a2c..." \
  -H "Content-Type: application/json"

# Node.js Example (using axios)
const axios = require('axios');

const response = await axios.get(
  'https://api.cloudnexus.io/v3/servers',
  {
    headers: {
      'Authorization': `Bearer ${process.env.CNX_API_KEY}`,
    },
  }
);

# Python Example (using requests)
import requests

response = requests.get(
  'https://api.cloudnexus.io/v3/servers',
  headers={
    'Authorization': f'Bearer {os.environ["CNX_API_KEY"]}',
  }
)

import { CloudNexus } from '@cloudnexus/sdk';

// Initialize the client
const cnx = new CloudNexus({
  apiKey: process.env.CNX_API_KEY,
  project: 'production-main',
});

// List all servers
const servers = await cnx.servers.list({
  region: 'us-east',
  status: 'running',
});

// Create a new server
const server = await cnx.servers.create({
  name: 'api-server',
  plan: 'professional',
  region: 'eu-west',
});

console.log(`Server created: ${server.id}`);

// Deploy an application
const deployment = await cnx.deployments.create({
  type: 'git',
  repoUrl: 'https://github.com/org/app',
  branch: 'main',
  env: {
    NODE_ENV: 'production',
    DATABASE_URL: process.env.DATABASE_URL,
  },
});

console.log(`Deployed to: ${deployment.url}`);

import os
import cloudnexus

# Initialize the client
cnx = cloudnexus.CloudNexus(
    api_key=os.environ["CNX_API_KEY"],
    project="production-main",
)

# List all servers
servers = cnx.servers.list(
    region="us-east",
    status="running",
)

# Create a new server
server = cnx.servers.create(
    name="api-server",
    plan="professional",
    region="eu-west",
)

print(f"Server created: {server.id}")

# Deploy from Git
deployment = cnx.deployments.create(
    type="git",
    repo_url="https://github.com/org/app",
    branch="main",
    env={"NODE_ENV": "production"},
)

print(f"Deployed to: {deployment.url}")

// Webhook payload example
{
  "id": "evt_9x8w7v6u",
  "type": "server.status_changed",
  "timestamp": "2025-01-15T10:30:00Z",
  "data": {
    "server_id": "srv_a8f3k2m",
    "server_name": "web-prod-01",
    "previous_status": "stopped",
    "new_status": "running",
    "region": "us-east"
  }
}

{
  "error": {
    "code": "SERVER_NOT_FOUND",
    "message": "The server 'srv_invalid' does not exist in this project.",
    "status": 404,
    "request_id": "req_abc123xyz",
    "details": {
      "resource_type": "server",
      "resource_id": "srv_invalid"
    }
  }
}