Get Managed Runner Stats
Managed Runners
Get Managed Runner Stats
Retrieve system statistics and information for a managed runner
GET
Get Managed Runner Stats
Overview
Fetch real-time system statistics from a managed ComfyUI runner, including hardware information, resource usage, installed extensions, and configuration settings.Access to managed runners requires a Pro or Plus tier subscription.
Path Parameters
string
required
The unique identifier (UUID) of the managed runner to query.
Response
object
required
System information.
string
Operating system name.
integer
Free RAM in bytes.
integer
Total RAM in bytes.
string
ComfyUI version number.
string
Python version running ComfyUI.
array
required
Array of compute devices (GPUs/CPUs) available to ComfyUI.
string
Device name/model.
string
Device type (e.g., “cuda”, “cpu”, “mps”).
integer
Total VRAM in bytes (for GPUs).
integer
Free VRAM in bytes (for GPUs).
boolean
required
Whether ComfyUI is running in development mode.
string[]
required
Array of installed ComfyUI extensions/custom nodes.
Example Response
Error Responses
error
Unauthorized - invalid or missing authentication token.
error
Forbidden - your account tier does not have access to managed runners. Upgrade to Pro or Plus tier.
error
Not Found - managed runner with the specified ID does not exist or is not available to your tier.
error
Internal Server Error - unable to retrieve stats from the managed runner.This is rare with managed runners due to high availability. Contact support if this persists.
Notes
- Managed runners typically have high-end GPUs (A100, H100, RTX 4090)
- VRAM and RAM values are in bytes (divide by 1,073,741,824 for GB)
- Stats are fetched in real-time and reflect current resource usage
- Use this to verify runner capacity before scheduling complex workflows
- Response time is typically faster than user-owned runners due to optimized infrastructure