Developer Platform
Build on your essentials.
The Super Engineered API exposes first-class primitives for every object we ship. REST today. GraphQL in private beta. gRPC on the roadmap.
Quickstart
curl -X POST https://api.superengineered.example/v1/toothbrush/tb_01H.../sessions \
-H "Authorization: Bearer $SUPERENGINEERED_KEY" \
-H "Content-Type: application/json" \
-d '{
"started_at": "2026-04-17T06:42:11Z",
"duration_ms": 122000,
"bristle_pattern": "adaptive-v4"
}'Endpoints
| Method | Path | Description |
|---|---|---|
| POST | /v1/toothbrush/:id/sessions | Create a new brushing session. |
| GET | /v1/toothbrush/:id/sessions/:session_id | Retrieve a brushing session. |
| POST | /v1/doorknob/:id/turns | Record a turn event (grip ID required). |
| GET | /v1/lightswitch/:id/state | Retrieve current switch state (authenticated). |
| PUT | /v1/lightswitch/:id/state | Set switch state. Requires scope: switch:write. |
| POST | /v1/spoon/:id/bites | Log a bite. Pro subscription required. |
| GET | /v1/fleet/devices | List devices in your organization's fleet. |
| POST | /v1/fleet/firmware/rollouts | Initiate a staged firmware rollout. Enterprise only. |
Authentication
All API requests require a bearer token. Generate tokens in your Super Engineered console. Enterprise customers may configure OAuth 2.0 scopes per device family.
Scopes
- toothbrush:read, toothbrush:write
- doorknob:read, doorknob:turn
- switch:read, switch:write
- spoon:bites:write
- fleet:admin
Rate Limits
Personal: 60 requests/minute per device. Pro: 600 req/min. Enterprise: negotiated. Exceeding your limit returns 429 Too Many Brushes.