Carato Cloud emblem
CARATO®CLOUD PRIVÉ
Sovereign Dedicated Silicon

Developer API Keys

Automate infrastructure provisioning, server power actions, and IPAM via REST API

Active API Subscriptions

Interactive OpenAPI Swagger Docs
Loading API keys...

How to use your Privé API Key

Pass your API key in the X-API-Key HTTP header or as a Bearer token:

# Set this once to your Carato Cloud URL

export CARATO_CLOUD_URL="https://carato.cloud"

# 1. List all servers

curl -X GET "$CARATO_CLOUD_URL/api/v1/servers" \
  -H "X-API-Key: vps_live_your_key_here"

# 2. Reboot a server instance

curl -X POST "$CARATO_CLOUD_URL/api/v1/servers/YOUR_SERVER_ID/power" \
  -H "X-API-Key: vps_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"action": "restart"}'

# 3. Carato AI chat completion (AI subscription key)

curl -X POST "$CARATO_CLOUD_URL/api/v1/ai/v1/chat/completions" \
  -H "X-API-Key: vps_ai_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"messages": [{"role": "user", "content": "Hello"}]}'