Usage & Analytics

Usage summary

GET /machine/usage

Returns resource counts, storage consumption, and quota limits.

{
  "resources": {
    "snapshots": 12,
    "files": 5,
    "apiKeys": 3
  },
  "storage": {
    "usedBytes": 5242880,
    "usedMB": 5.0
  },
  "quotas": {
    "maxSnapshots": 50,
    "maxFiles": 100,
    "maxStorageBytes": 104857600,
    "maxStorageMB": 100.0,
    "maxRequestsPerMinute": 60,
    "maxRequestsPerDay": 10000
  }
}

Request history

GET /machine/usage/requests

Aggregated API call history grouped by time period and endpoint.

Param	Type	Default	Description
period	string	"day"	Aggregation: hour, day, week, month
from	string	30 days ago	Start date (ISO 8601)
to	string	Now	End date (ISO 8601)

{
  "period": "day",
  "from": "2026-02-01T00:00:00.000Z",
  "to": "2026-02-07T12:00:00.000Z",
  "data": {
    "2026-02-07": {
      "total": 48,
      "endpoints": [
        { "path": "/machine/snapshots", "statusCode": 200, "count": 30, "avgResponseMs": 12 },
        { "path": "/machine/files", "statusCode": 201, "count": 18, "avgResponseMs": 45 }
      ]
    }
  }
}

Live request feed

GET /machine/usage/requests/live

Last 100 raw API requests, most recent first.

{
  "requests": [
    {
      "method": "POST",
      "path": "/machine/snapshots",
      "statusCode": 201,
      "responseTimeMs": 15,
      "createdAt": "2026-02-07T12:00:00.000Z"
    }
  ]
}