API v1

API Reference

The DashVault local API is served from http://127.0.0.1:8787 and mirrors the dashboard's capabilities. All endpoints return JSON.

GET/api/videosList videos with pagination and filters.
Response 200
{
  "items": [
    {
      "id": "vid-1",
      "name": "trip001_seg1.mp4",
      "status": "processed"
    }
  ],
  "total": 42
}
GET/api/videos/:idFetch a single video.
Response 200
{
  "id": "vid-1",
  "duration": 420,
  "resolution": "1080p",
  "incidents": 0
}
POST/api/videos/importTrigger local import from a folder.
Request
{
  "path": "/Volumes/DASHCAM"
}
Response 200
{
  "imported": 12,
  "skipped": 1
}
PATCH/api/videos/:idUpdate tags or status.
Request
{
  "status": "archived",
  "tags": [
    "highway"
  ]
}
Response 200
{
  "ok": true
}
DELETE/api/videos/:idPermanently remove a video and its metadata.
Response 200
{
  "deleted": true
}