Developer API Keys
Automate infrastructure provisioning, server power actions, and IPAM via REST API
Active API Subscriptions
Interactive OpenAPI Swagger DocsHow 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"}]}'
