Fleet Management

Once your devices are provisioned, the manufacturer portal and REST API give you full visibility and control over your fleet.

Manufacturer portal

The portal is available at support.klstr.cloud/portal. After logging in with your manufacturer credentials, you have access to:

Dashboard

The dashboard shows an overview of your account:

• Provisioned devices — total count and breakdown by fixture model
• Online / offline — real-time device status
• Allowance — devices provisioned vs. your allocation quota
• Budget — spend tracking against your manufacturer budget

Device list

The Fleet > Devices view shows every device bound to your account:

You can filter by fixture model, status, or firmware version. Click any device to view its full configuration and history.

Firmware management

From the portal, you can:

• View available firmware versions per device model
• Schedule OTA firmware updates for individual devices or batches
• Track update progress and rollback if needed
• View firmware changelog and release notes

Note

OTA updates require the device to be online and connected to the internet. For air-gapped installations, use KLSTR.ctrl with a USB-C connection.

REST API

For production automation, KLSTR. provides a REST API that covers all portal functionality programmatically.

Authentication

All API requests require a manufacturer API key, generated in the portal under Settings > API Keys.

Authorization: Bearer <your-api-key>

Key endpoints

Example: List devices

curl -H "Authorization: Bearer $API_KEY" \  https://api.klstr.cloud/api/v1/devices

{  "devices": [    {      "serial": "KN2-00A1B2C3",      "name": "venue-a-truss-1",      "model": "WashPro 500",      "firmware": "2.1.0",      "status": "online",      "last_seen": "2026-04-24T12:30:00Z",      "ip": "192.168.1.42"    }  ],  "total": 142,  "quota": 500}

Example: Bulk firmware update

curl -X POST \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{    "firmware_version": "2.1.1",    "filter": { "model": "WashPro 500", "firmware_lt": "2.1.1" }  }' \  https://api.klstr.cloud/api/v1/firmware/deploy

This schedules an OTA update for all WashPro 500 devices running firmware older than 2.1.1.

Caution

The API is rate-limited to 100 requests per minute per API key. For bulk operations, use the batch endpoints rather than iterating over individual devices.

Bulk provisioning API

For production lines, the claim endpoint supports batch operations:

curl -X POST \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{    "serials": ["KN2-00A1B2C3", "KN2-00A1B2C4", "KN2-00A1B2C5"],    "model": "WashPro 500",    "firmware": "2.1.0"  }' \  https://api.klstr.cloud/api/v1/devices/claim

This claims multiple devices, assigns them to a fixture model, and schedules firmware installation — all in a single request.

Webhooks (coming soon)

KLSTR. is developing webhook support for real-time event notifications:

• Device comes online / goes offline
• Firmware update completed / failed
• Allocation threshold reached

Contact your account manager to join the webhook beta program.