VigorLabs Developer
  1. VigorLabs Developer Platform
  2. Cloud API
API Reference

Query devices, events, playback availability, and workspace policies.

Last updated on: 2026-04-01 Reference

The Cloud API is optimized for inventory reads, event queries, playback governance, and workspace-level operational workflows.

Endpoint families

FamilyPurpose
/v1/devicesInventory, status, metadata, ownership mapping
/v1/eventsEvent history, filtering, pagination, reconciliation
/v1/mediaPlayback windows, player sessions, clip lifecycle
/v1/workspacesProjects, policies, token scopes, audit state

Example event query

GET /v1/events?device_id=cam_01J2X&event_type=camera.motion.detected&limit=50
Authorization: Bearer <access_token>

{
  "data": [
    {
      "id": "evt_81ab",
      "event_type": "camera.motion.detected",
      "occurred_at": "2026-04-01T11:32:18Z"
    }
  ],
  "next_cursor": "evt_81ab"
}

Usage guidance

  1. Use server-side filters instead of broad fetches where possible.
  2. Persist cursors for reliable reconciliation, not only timestamps.
  3. Keep playback authorization separate from event ingestion workers.
  4. Expect pagination for fleet-scale inventories and long timelines.