Status

GET /runtime/status

Requires: read (viewer+)

Returns comprehensive runtime state, project info, system metrics, and cumulative statistics. Responds immediately without queuing a lifecycle action.

Parameters: None

Response: 200 OK — JSON object:

{
  "state": "Running",
  "project": {
    "fileName": "C:\\Projects\\MyProject.prj",
    "name": "MyProject.prj",
    "loaded": true,
    "startedUtc": "2026-04-18T10:00:00.0000000Z",
    "uptime": "0.02:15:30",
    "uptimeSeconds": 8130,
    "computeTimeMsShort": 4.52,
    "computeTimeMsLong": 4.48,
    "computeTimePercent": 27.05,
    "budgetExceededFrames": 0,
    "congestions": 0,
    "queueFlushes": 0,
    "errors": 0,
    "warnings": 2,
    "expectedState": {
      "unknown": 1,
      "running": 3,
      "stopped": 0,
      "mismatched": 1
    }
  },
  "system": {
    "ramUsageGb": 3.456,
    "gpuMemoryUsedGb": 2.100,
    "gpuMemoryFreeGb": 5.900,
    "gpuMemoryTotalGb": 8.000
  },
  "runtime": {
    "hostname": "ENCODER-01",
    "composerVersion": "2.6.9645.23784",
    "operatingSystem": "Microsoft Windows NT 10.0.26200.0",
    "startedUtc": "2026-04-18T08:00:00.0000000Z",
    "uptime": "0.04:15:30",
    "uptimeSeconds": 15330,
    "totalProjectsStarted": 3,
    "totalReloads": 1,
    "totalApiCalls": 47,
    "totalErrors": 0,
    "totalWarnings": 5,
    "lastReloadDurationSeconds": 2.34,
    "lastTimeToFirstFrameSeconds": 1.87
  },
  "timestamp": "2026-04-18T12:15:30.0000000Z"
}

Response fields:

state (string)

Current runtime state: Idle, Loading, Running, or Stopping.

project object

expectedState object

Expected state is what a component was last asked to be: Running after somebody started it, Stopped after somebody stopped it, Unknown until one of them happens. A component configured to start with the project counts as asked — the project's autostart records Running on it, so an unattended runtime whose feeds all come up by autostart still reports intent and can still report a mismatch. What is recorded is the request the project could actually make: a component configured to autostart that the project had nothing to act on — an input with no source selected, a media player with no file — stays Unknown rather than becoming a permanent mismatch. Stopping the project returns every component to Unknown.

Inputs that are never started or stopped are not counted: scenes, the ones Composer simply draws (still image, rectangle, text), the control surfaces that act on other components (switcher, batch processor, interactive button) and the internal audio buses (audio channel strip and the generated channel splits). Counting them would fill unknown with components that can never leave it — and unknown is read as "not started yet". The targets inside a scene are counted like any others.

The Runtime API is deliberately project-level and reports no per-component detail; for that, use the project HTTP API's /api/inputs/get/status and /api/targets/get/status, or the composer_ext_input_expected_state and composer_ext_target_expected_state Prometheus gauges, which carry one series per component.

system object

runtime object