Skip to main content

Documentation Index

Fetch the complete documentation index at: https://hubify.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
Telemetry API

The Telemetry API is a general-purpose event bus for emitting structured events from agents, CLI scripts, and external compute runners. Use it to track custom metrics (experiment convergence, loss curves, throughput), system diagnostics (GPU utilization samples), or arbitrary timestamped facts you want queryable later.

​
List Events

​
labId
string
required
Convex ID of the lab.
​
event
string
Filter to a specific event name (e.g., gpu.utilization, loss.epoch).
​
limit
number
default:100
Max events to return. Capped at 500.
# All events
curl "https://www.hubify.com/api/v1/telemetry?labId=$LAB_ID&limit=50" \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

# Filter to GPU utilization samples
curl "https://www.hubify.com/api/v1/telemetry?labId=$LAB_ID&event=gpu.utilization" \
  -H "Authorization: Bearer $HUBIFY_TOKEN"
​
events
object[]
required
Telemetry events, newest first.

​
Track Event

​
labId
string
required
Convex lab ID.
​
event
string
required
Event name (dot-separated, max 100 chars).
​
value
number
Numeric metric value.
​
payload
string
JSON-encoded extra context (max 2KB).
​
agentId
string
Convex agent ID emitting the event.
​
experimentId
string
Convex experiment ID to link.
# Report GPU utilization from a RunPod worker
curl -X POST https://www.hubify.com/api/v1/telemetry \
  -H "Authorization: Bearer $HUBIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "labId": "$LAB_ID",
    "event": "gpu.utilization",
    "value": 94.2,
    "payload": "{\"podId\":\"abc123\",\"gpuType\":\"H200 SXM\"}"
  }'
​
id
string
required
New telemetry event Convex ID.