Connect a machine

Factory OS ingests telemetry over MQTT or REST. MQTT is preferred for high-frequency sample data; REST is fine for low-rate integrations or batch backfills.

1. Register the machine

Create a machine record via the dashboard or API:

curl -X POST https://api.xentr.ai/api/factories/biocare-main/machines \
  -H "Authorization: Bearer $XENTR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "CNC-001",
    "name": "Haas VF-2",
    "type": "cnc"
  }'

2. Provision credentials

Request MQTT credentials for the machine:

curl -X POST https://api.xentr.ai/api/provisioning/machines/CNC-001/credentials \
  -H "Authorization: Bearer $XENTR_TOKEN"

You'll receive an MQTT username, password, and topic prefix.

3. Publish telemetry

Publish samples to factories/<slug>/machines/<code>/telemetry:

{
  "ts": "2026-04-18T12:00:00Z",
  "metrics": {
    "spindle_rpm": 4500,
    "feed_rate": 1200,
    "state": "running"
  }
}

Samples are written to TimescaleDB and made available to OEE, quality, and dashboard queries in real time.

4. Verify in dashboard

Open your factory in the Xentr dashboard — the machine should show live data within 10 seconds of the first publish.