← Docs|API Reference

API Reference

REST API endpoints for programmatic access to Wozz Monitor.

Base URL

https://wozz.io/api
POST/api/push

Push audit data to the platform. Returns a claim URL if no token provided.

Request Body

{
  "cluster_hash": "abc123...",
  "api_token": "wozz_xxx..." // optional
  "audit_data": {
    "timestamp": "2024-12-08T10:30:00Z",
    "cluster": {
      "totalPods": 234,
      "totalNodes": 12
    },
    "costs": {
      "monthlyWaste": 4333,
      "annualSavings": 52000
    }
  }
}

Response

{
  "success": true,
  "claim_url": "https://wozz.io/claim?token=xyz..."
}
GET/api/audits/[cluster_id]

Retrieve audit history for a specific cluster.

Headers

Authorization: Bearer wozz_your_token_here

Response

{
  "audits": [
    {
      "id": "uuid...",
      "cluster_id": "uuid...",
      "waste_annual": 52000,
      "waste_monthly": 4333,
      "created_at": "2024-12-08T10:30:00Z"
    }
  ]
}
POST/api/tokens

Generate a new API token for authenticated requests.

Request

{
  "name": "CI/CD Token"
}

Response

{
  "token": "wozz_abc123...",
  "name": "CI/CD Token",
  "created_at": "2024-12-08T10:30:00Z"
}

Authentication

Most endpoints require authentication via API token:

Authorization: Bearer wozz_your_token_here

Get your API token from the dashboard: Settings → API