Skip to main content

Fleet Management

Fleet-wide status, multi-site management, and cross-site KPI comparison.

Fleet status​

GET /fleet/status

Auth: Bearer JWT (any role)

Returns the current status of all machines in your fleet.

curl https://api.haltless.io/api/v1/fleet/status \
  -H "Authorization: Bearer YOUR_TOKEN"
{
  "total_machines": 45,
  "machines": [
    {
      "id": "uuid",
      "name": "CNC Mill #1",
      "machine_identifier": "CNC-001",
      "status": "healthy",
      "alert_count": 0,
      "last_reading_at": "2026-04-04T10:30:00Z"
    },
    {
      "id": "uuid",
      "name": "Pump Station A",
      "machine_identifier": "PUMP-A1",
      "status": "warning",
      "alert_count": 2,
      "last_reading_at": "2026-04-04T10:29:00Z"
    }
  ]
}

Site management​

List sites​

GET /fleet/sites

Auth: Bearer JWT (any role)

Site KPIs​

GET /fleet/sites/{site_id}/kpis

Auth: Bearer JWT (any role)

Returns detailed KPIs for a specific site, including machine counts by status, alert counts, and uptime percentages.

Cross-site comparison​

GET /fleet/sites/comparison

Auth: Bearer JWT (any role)

Compare KPIs across all sites in a single response.

Public status page​

GET /status

Auth: None required

Returns a public status view for tenants that have opted in. Includes machine counts, alert counts, and 30-day uptime percentages. No authentication required.

{
  "entries": [
    {
      "tenant_name": "Acme Mfg",
      "total_machines": 45,
      "healthy_count": 40,
      "alert_count": 5,
      "uptime_30d_percent": 98.5
    }
  ]
}

Enable the public status page via PATCH /settings/status-page:

{"status_page_enabled": true}