Developer documentation

Engineered for cognitive flow state

Zero-overhead git telemetry and IDE metrics delivered via a single, lightweight REST API. No screen tracking, no invasive spyware, just pure flow analytics.

< 45ms

Response latency

99.99%

API uptime

Frictionless integration

The single curl integration

Initialize telemetry across your entire CI/CD pipeline with one command. Our lightweight payload captures passive git metadata without slowing down local compilation cycles.

Step 01
BASH // TERMINAL

Authenticate environment

export FLOWIQ_TOKEN="fiq_live_8f3c2a" curl -X POST https://api.flowiq.io/v1/telemetry \ -H "Authorization: Bearer $FLOWIQ_TOKEN" \ -d @git-metadata.json

Export your unique API token to your local environment variables to authorize the telemetry daemon safely.

Step 02

Trigger pipeline telemetry

Append the telemetry hook to your post-commit script or CI configuration file to begin passive tracking immediately.

Predictable endpoints

The telemetry schema

Query real-time flow metrics, cognitive load thresholds, and active developer friction points through structured JSON payloads designed for immediate dashboard integration.

POST /v1/metrics
HTTP 200 OK

{ "developer_id": "dev_994x", "active_window_ms": 1800000, "git_commits": 3, "file_changes": 14, "keystroke_intervals_ms": [120, 450, 80] }

{ "status": "success", "flow_state_score": 87, "cognitive_load": "optimal", "friction_detected": false, "recommended_break_ms": 0 }

Ready to measure flow

Create your free account today and integrate our API with your local development environment in less than five minutes.