List Managed Runners
Managed Runners
List Managed Runners
Retrieve a paginated list of available managed runners
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, prostring
required
Current status of the runner. Values:
active, disabledstring[]
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
totalfield indicates the total count of available managed runners for your tier