API Keys & Tokens

Create & Manage Keys

Generate API keys from the Developer Console or via the management API. Each key can be scoped to specific services, environments, and permission levels.

Active Tokens

Authentication Examples

Include your API key in the Authorization header or as a query parameter. Header-based authentication is strongly recommended for production.

curl -X GET "https://api.cloudnexus.io/v2/instances" \\
  -H "Authorization: Bearer cnx_prod_8xK9mP2vL5qR7wN3tJ6yH1cZ4bA0eD" \\
  -H "Content-Type: application/json"

import requests

api_key = "cnx_prod_8xK9mP2vL5qR7wN3tJ6yH1cZ4bA0eD"
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

response = requests.get("https://api.cloudnexus.io/v2/instances", headers=headers)
print(response.json())

const fetch = require('node-fetch');

const apiKey = 'cnx_prod_8xK9mP2vL5qR7wN3tJ6yH1cZ4bA0eD';
const response = await fetch('https://api.cloudnexus.io/v2/instances', {
    headers: {
        'Authorization': `Bearer ${apiKey}`,
        'Content-Type': 'application/json'
    }
});

console.log(await response.json());

Token Types & Scopes

• compute:read - List and describe VPS/VM instances
• compute:write - Create, update, and terminate instances
• storage:admin - Full access to object storage and databases
• network:read - View load balancers, firewalls, and DNS records

Rate Limits & Best Practices

When rate limited, the API returns a 429 status with a Retry-After header. Implement exponential backoff in your client logic.

Frequently Asked Questions