Skip to main content
GET
/
v1
/
managed-runner
List Managed Runners
curl --request GET \
  --url https://api.comfycontrol.app/v1/managed-runner \
  --header 'Authorization: Bearer <token>'
{
  "401": {},
  "403": {},
  "runners": [
    {}
  ],
  "total": 123,
  "runners[].id": "<string>",
  "runners[].name": "<string>",
  "runners[].runner_type": "<string>",
  "runners[].status": "<string>",
  "runners[].tags": [
    "<string>"
  ],
  "runners[].created_at": "<string>",
  "runners[].updated_at": "<string>"
}

​
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

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

​
Response

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

​
Managed Runner Object

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

​
Example Response

{
  "runners": [
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "Managed Pro Runner 1",
      "runner_type": "pro",
      "status": "active",
      "tags": ["managed", "gpu-a100", "high-performance"],
      "created_at": "2024-01-10T08:00:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    },
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "Managed Plus Runner 1",
      "runner_type": "plus",
      "status": "active",
      "tags": ["managed", "gpu-rtx4090", "standard"],
      "created_at": "2024-01-10T08:00:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    }
  ],
  "total": 2
}

​
Error Responses

​
401
error
Unauthorized - invalid or missing authentication token.
​
403
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