Skip to main content

​
Dashboard API reference

The dashboard API is mounted by the daemon (voicegw serve) under the /api/ prefix on the same port as the public HTTP API (/v1/*) and the React SPA (/). The default port is 8080; the serve.port key in voicegw.yaml overrides it. Start the daemon (the dashboard API ships with it): 
voicegw serve

​
GET /api/status

Returns the configuration status of all providers, registered models, and fallback chains. Response: 
{
  "providers": {
    "deepgram": { "configured": true, "type": "cloud" },
    "openai": { "configured": true, "type": "cloud" },
    "whisper": { "configured": true, "type": "local" }
  },
  "models": {
    "deepgram/nova-3": { "modality": "stt", "provider": "deepgram" },
    "openai/gpt-4o-mini": { "modality": "llm", "provider": "openai" }
  },
  "fallbacks": {
    "stt": ["deepgram/nova-3", "local/whisper-large-v3"],
    "llm": ["openai/gpt-4o-mini", "groq/llama-3.3-70b-versatile"],
    "tts": ["cartesia/sonic-3", "local/kokoro"]
  }
}
Example: 
curl http://localhost:8080/api/status

​
GET /api/costs

Return cost summary for a period, optionally filtered by project. Includes per-project breakdown when no project filter is applied. Query parameters:
ParameterTypeDefaultDescription
periodstring"today"One of: today, week, month, all.
projectstringnullFilter by project ID.
Response: 
{
  "period": "today",
  "total": 3.4521,
  "by_provider": {
    "deepgram": { "cost": 1.2000, "requests": 85 },
    "openai": { "cost": 2.2521, "requests": 42 }
  },
  "by_model": {
    "deepgram/nova-3": { "cost": 1.2000, "requests": 85 },
    "openai/gpt-4o-mini": { "cost": 2.2521, "requests": 42 }
  },
  "by_project": {
    "tonys-pizza": { "cost": 2.1000, "requests": 90 },
    "sushi-bot": { "cost": 1.3521, "requests": 37 }
  }
}
Example: 
curl "http://localhost:8080/api/costs?period=week"
curl "http://localhost:8080/api/costs?period=today&project=tonys-pizza"

​
GET /api/latency

Return latency statistics, optionally filtered by project. Query parameters:
ParameterTypeDefaultDescription
periodstring"today"One of: today, week.
projectstringnullFilter by project ID.
Response: Per-model latency statistics including average TTFB and total latency. Example: 
curl "http://localhost:8080/api/latency?period=today"
curl "http://localhost:8080/api/latency?project=my-app"

​
GET /api/logs

Return recent request logs. Query parameters:
ParameterTypeDefaultDescription
limitinteger100Number of rows to return (1-1000).
modalitystringnullFilter: stt, llm, or tts.
projectstringnullFilter by project ID.
Response: An array of log records, each containing timestamp, project, modality, model_id, cost_usd, total_latency_ms, status. Example: 
curl "http://localhost:8080/api/logs?limit=50&modality=stt"
curl "http://localhost:8080/api/logs?project=tonys-pizza"

​
GET /api/overview

Return aggregated dashboard overview statistics. This endpoint combines multiple queries into a single response for the dashboard’s summary cards. Query parameters:
ParameterTypeDefaultDescription
projectstringnullFilter all stats by project ID.
Response: 
{
  "total_requests": 12450,
  "total_cost_today": 15.23,
  "total_cost_all": 342.87,
  "active_models": 8,
  "providers_configured": 5
}
Example: 
curl http://localhost:8080/api/overview
curl "http://localhost:8080/api/overview?project=tonys-pizza"

​
GET /api/projects

List all configured projects with today’s stats. Response: 
{
  "projects": [
    {
      "id": "tonys-pizza",
      "name": "Tony's Pizza",
      "description": "Pizza ordering voice agent",
      "daily_budget": 10.0,
      "default_stack": "premium",
      "tags": ["production"],
      "accent": "#e74c3c"
    }
  ],
  "stats": {
    "tonys-pizza": {
      "cost_today": 2.45,
      "requests_today": 120
    }
  }
}
Example: 
curl http://localhost:8080/api/projects

​
Static File Serving

The dashboard also serves the React frontend’s built assets. If the frontend has been built (src/dashboard/frontend/dist/ exists), the dashboard serves:
  • GET / — the React app’s index.html
  • GET /assets/* — bundled JavaScript, CSS, and other static files
  • All other paths fall through to index.html for client-side routing (SPA fallback)
If the frontend has not been built, GET / returns an error message with build instructions.