Skip to main content
GET
List Managed Runners

Overview

Retrieve all managed runners available to your account. Managed runners are ComfyUI instances hosted and maintained by ComfyControl.
Access to managed runners requires a Pro or Plus tier subscription. Free tier users will receive a 403 Forbidden error.

Query Parameters

integer
Page number to retrieve (default: 1, minimum: 1).
integer
Number of runners per page (default: 10, minimum: 1, maximum: 100).

Response

array
required
Array of managed runner objects.
integer
required
Total number of managed runners available to your tier across all pages.

Managed Runner Object

string
required
Unique identifier (UUID) for the managed runner.
string
required
The runner’s name.
string
required
Type of managed runner. Values: plus, pro
string
required
Current status of the runner. Values: active, disabled
string[]
required
Array of tags associated with the runner for workflow matching.
string
required
ISO 8601 timestamp when the runner was created.
string
required
ISO 8601 timestamp when the runner was last updated.

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.

Notes

  • Only active managed runners are returned in the list
  • Managed runners are maintained by ComfyControl with high availability
  • Runner type corresponds to your subscription tier (Pro or Plus)
  • Results are ordered by creation date (newest first)
  • The total field indicates the total count of available managed runners for your tier