Set up your workspace and make the first authenticated request.

Last updated on: 2026-04-01 Guide

This guide covers the fastest path from a new developer workspace to a working sandbox integration using the VigorLabs platform.

Create the right environment first

Create a dedicated workspace for the product or business unit consuming camera data.
Issue separate sandbox and production credentials from day one.
Grant only the scopes needed for the APIs, devices, and playback surfaces your integration uses.

Separate sandbox and production early. It prevents accidental data crossover and makes audit review much cleaner later.

Request your first access token

curl -X POST https://api.vigorlabs.example/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "vl_workspace_123",
    "client_secret": "vl_secret_abc",
    "environment": "sandbox"
  }'

Use short-lived bearer tokens for API requests. Rotate client secrets on a schedule that matches your internal policy.

List devices in your workspace

GET /v1/devices?workspace_id=ws_01J2X
Authorization: Bearer <access_token>

{
  "data": [
    {
      "id": "cam_01J2X",
      "name": "Front Lobby",
      "status": "online",
      "model": "VigorCam Pro"
    }
  ]
}

If your integration will render live feeds, map devices to tenant or site IDs at this stage.

If your integration is event-driven, enable webhook signing before connecting downstream automation.

Recommended next steps

Read Platform Architecture to understand the flow between devices, media, and events.
Move into Cloud API for endpoint families and response patterns.
Use Webhooks if you need low-latency event delivery.