vss-call-vios-api

name	vss-call-vios-api
description	Interact with the VIOS (Video IO & Storage) microservice in a running VSS profile — manage cameras/sensors, RTSP streams, recordings, snapshots, and storage. Use when asked to add a camera, add an RTSP stream, list sensors, show configured sensors/cameras/streams, what sources are available, check stream status, start/stop recording, get a snapshot, or manage video storage. Always query the VIOS API directly — do not navigate the UI to answer these questions.
owner	NVIDIA
service	vss-sop
version	1.0.0
license	CC-BY-4.0 AND Apache-2.0
reviewed	"2026-06-23T00:00:00.000Z"
metadata	{"openclaw":{"emoji":"📷","os":["linux"]},"author":"nvidia <[e-mail]>","tags":["vss","vios","camera","vms"]}

Sensor Operations (VIOS)

VIOS manages cameras, live/replay streams, recordings, and storage for all VSS profiles.

Overview

Use this skill when you need to query, add, modify, or remove sensors/cameras in a VSS deployment. Always invoke the VIOS API programmatically; do not instruct the user to use the Web UI.

Key outcomes:

• Listing configured cameras or active RTSP streams.
• Adding new RTSP cameras via direct URLs.
• Inspecting recording timelines and stream health.
• Getting snapshots (images) or temporary playback URLs.

Prerequisites

• Network Connectivity: Ensure host port 30888 is open and reachable.
• RTSP Sources: Any added RTSP URL must be accessible from the host system.

Instructions

1. Host IP Detection

All VIOS API calls are directed at port 30888 on the target host. Detect the host IP using standard system utility commands:

ip route get 1.1.1.1 | awk '{print $7; exit}'

2. Sensor Registration & Management

Manage video sources via the /sensor/ endpoint. Response payloads from the /sensor/add endpoint return a unique sensorId which is required for subsequent operations.

3. Recording & Livestream Control

To control disk recording, invoke start/stop endpoints under /record/.

4. Storage & Playback URLs

Retrieve temporary video clip URLs or clean up media files via /storage/ endpoints.

Examples

List All Configured Sensors

curl -s http://localhost:30888/vst/api/v1/sensor/list | jq .

Add RTSP Video Source

curl -s -X POST http://localhost:30888/vst/api/v1/sensor/add \
  -H "Content-Type: application/json" \
  -d '{
    "sensorUrl": "rtsp://localhost:8552/sensor_0",
    "username": "",
    "password": "",
    "name": "front-entrance"
  }' | jq .

Check Stream Status

# All sensors
curl -s http://localhost:30888/vst/api/v1/sensor/status | jq .

# Specific sensor
curl -s http://localhost:30888/vst/api/v1/sensor/<sensorId>/status | jq .