DEVELOPER GATEWAY

API REFERENCE

Automate, monitor, and customize your physical Ron Bot companion via our global, low-latency REST API. Build custom calendar syncs, alert signals, or integrations with third-party tools.

GETTING STARTED

Authentication Base Gateway

ENDPOINTS

GET/api/v1/telemetryPOST/api/v1/bot/controlPOST/api/v1/matrix/tasks

Authentication

All requests to the TYVIK API must include your unique developer token in the header. Authenticate your API keys generated in your TYVIK Portal:

Authorization: Bearer YOUR_API_KEY

Base URL

All request paths are relative to our secure edge gateway environment.

https://api.tyvik.com
GET/api/v1/telemetry

Fetch real-time hardware telemetry and environmental data from the active Ron Bot device, including temperature, battery status, active network latency, and current visual eye expressions.

curl -X GET "https://api.tyvik.com/api/v1/telemetry" \
  -H "Authorization: Bearer YOUR_API_KEY"
RESPONSE (JSON)
{
  "status": "success",
  "data": {
    "device_id": "ron_classic_8b73",
    "online": true,
    "battery": {
      "percentage": 87,
      "charging": false,
      "voltage": 3.82
    },
    "sensors": {
      "temperature_celsius": 24.5,
      "humidity_percentage": 48
    },
    "display": {
      "active_screen": "tft_robo_eyes",
      "brightness": 75,
      "mood": "playful"
    },
    "network": {
      "ssid": "TYVIK_Core_5G",
      "signal_strength_dbm": -52,
      "latency_ms": 14
    }
  }
}
POST/api/v1/bot/control

Publish control payloads directly to the Ron Bot command queue to change eye expressions, flip clock displays, trigger audio alerts, or adjust physical configuration states.

Request Body
{
  "action": "set_mood",
  "parameters": {
    "mood": "focused",
    "brightness": 90,
    "duration_seconds": 3600
  }
}
curl -X POST "https://api.tyvik.com/api/v1/bot/control" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "set_mood",
    "parameters": {
      "mood": "focused",
      "brightness": 90,
      "duration_seconds": 3600
    }
  }'
RESPONSE (JSON)
{
  "status": "success",
  "message": "Command successfully queued to device",
  "job_id": "job_99812a"
}
POST/api/v1/matrix/tasks

Sync active tasks to the physical Ron Bot Task Matrix. Allows remote pushes from calendars, Kanban boards, or custom scripts to be rendered on the device.

Request Body
{
  "tasks": [
    {
      "id": "t1",
      "title": "Code Review",
      "duration_minutes": 45,
      "color": "#7c4dff"
    },
    {
      "id": "t2",
      "title": "UI Audit",
      "duration_minutes": 30,
      "color": "#3ddc84"
    }
  ]
}
curl -X POST "https://api.tyvik.com/api/v1/matrix/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tasks": [
      {
        "id": "t1",
        "title": "Code Review",
        "duration_minutes": 45,
        "color": "#7c4dff"
      }
    ]
  }'
RESPONSE (JSON)
{
  "status": "success",
  "synced_items_count": 2,
  "last_synced_at": "2026-06-25T10:00:00Z"
}