Newcell commissioning in under 6 weeks. Book a call
qtvue

API reference

Integrate with the qtvue platform.

REST API for managing your deployed cells: health, uptime, cycle counts, alerts, program versions, and remote hand-off. Authenticated with a per-cell bearer token.

GET

/v1/cells

List all cells you have access to. Returns cell ID, name, status, uptime, and last-seen timestamp.

curl
bash
curl -H "Authorization: Bearer $QTVUE_KEY" \
  https://api.qtvue.com/v1/cells

# Response
{
  "cells": [
    { "id": "CELL-07", "name": "Weld line 7", "status": "online", "uptime_pct": 99.7 },
    { "id": "CELL-12", "name": "Pack line 1", "status": "online", "uptime_pct": 99.1 }
  ]
}
GET

/v1/cells/:id

Get full health, cycle-time history, and active program for a single cell.

curl
bash
curl -H "Authorization: Bearer $QTVUE_KEY" \
  https://api.qtvue.com/v1/cells/CELL-07

# Response
{
  "id": "CELL-07",
  "name": "Weld line 7",
  "status": "online",
  "uptime_pct": 99.7,
  "cycle_time_s": 28.4,
  "active_program": "weld_v12.karel",
  "last_seen": "2026-06-22T00:30:00Z"
}
POST

/v1/cells/:id/reload

Push a new program version to a cell. Atomic swap with automatic rollback if the cell doesn't acknowledge within 30 seconds.

curl
bash
curl -X POST \
  -H "Authorization: Bearer $QTVUE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"program": "weld_v13.karel", "checksum": "sha256:..."}' \
  https://api.qtvue.com/v1/cells/CELL-07/reload

# Response
{ "status": "applied", "version": 13, "applied_at": "2026-06-22T00:30:00Z" }
GET

/v1/cells/:id/alerts

Stream live alerts via SSE: errors, warnings, predictive-maintenance signals, and support-ticket updates.

curl
bash
curl -N -H "Authorization: Bearer $QTVUE_KEY" \
  https://api.qtvue.com/v1/cells/CELL-07/alerts

# SSE stream of alerts
event: alert
data: {"level":"warning","code":"W-203","message":"EOAT cycle count approaching threshold","ts":"..."}

Authentication

Bearer token per cell.

Every cell ships with a unique bearer token. Pass it in the Authorization header. Tokens can be rotated from the dashboard without downtime.

Request API accessRead the docs
auth-example.sh
bash
# Set your cell's API key
export QTVUE_KEY="qtv_••••••••••••"

# Test it
curl -H "Authorization: Bearer $QTVUE_KEY" \
  https://api.qtvue.com/v1/ping

# Rotate (no downtime)
curl -X POST -H "Authorization: Bearer $QTVUE_KEY" \
  https://api.qtvue.com/v1/cells/CELL-07/rotate-key