Integrate Arizen Cloud hosting, server power actions, subscription lifecycle events, and billing telemetry directly into your Discord bots, deployment pipelines, and control panels.
All API requests must be authenticated using a customer API key passed in the standard Authorization: Bearer <KEY> header or via the X-API-Key header. Secret keys begin with the az_live_ prefix.
curl -X GET "https://api.azcloud.site/api/v1/account" \ -H "Authorization: Bearer az_live_example_secret_key" \ -H "Accept: application/json"
| Scope | Description | Associated Endpoints |
|---|---|---|
| account:read | View customer profile & API usage telemetry | GET /account, GET /account/usage |
| services:read | List hosting services, specs & utilization | GET /services, GET /services/:id, GET /servers/:id/utilization |
| servers:control | Execute power actions (start, stop, restart, kill) | POST /servers/:id/power |
| orders:read | View customer orders history | GET /orders, GET /orders/:id |
| invoices:read | View invoices and transaction receipts | GET /invoices, GET /invoices/:id |
| webhooks:manage | Register, test, and remove webhook endpoints | POST/GET/DELETE /webhooks |
Send real-time power signals to your server instances. Signals must be one of: start, stop, restart, or kill. Requests verify customer ownership and prevent power actions on suspended services.
curl -X POST "https://api.azcloud.site/api/v1/servers/8b7e2a44/power" \
-H "Authorization: Bearer az_live_example_secret_key" \
-H "Content-Type: application/json" \
-d '{"action": "restart"}'Outgoing webhook requests include the header X-Arizen-Signature: t=<timestamp>,v1=<signature>. To ensure authenticity and prevent replay attacks, calculate HMAC-SHA256 over <timestamp>.<raw_payload> using your secret and perform constant-time comparison.
# Webhooks arrive via HTTP POST from Arizen Cloud # Signature header: X-Arizen-Signature: t=1690000000,v1=abc123hex...
All endpoints return a uniform JSON envelope containing success, data, and optional meta or error objects.
{
"success": true,
"data": { ... },
"meta": {
"pagination": { "page": 1, "limit": 10, "total": 42 },
"timestamp": "2026-11-16T12:00:00.000Z"
}
}{
"success": false,
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Too many requests. Please slow down."
},
"meta": {
"timestamp": "2026-11-16T12:00:00.000Z"
}
}