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

​
Overview

Retrieve detailed information about a specific managed runner by its ID. Managed runners are ComfyUI instances hosted and maintained by ComfyControl.
Access to managed runners requires a Pro or Plus tier subscription.

​
Path Parameters

​
id
string
required
The unique identifier (UUID) of the managed runner to retrieve.

​
Response

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

​
Example Response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Managed Pro Runner 1",
  "runner_type": "pro",
  "status": "active",
  "tags": ["managed", "gpu-a100", "high-performance", "image-generation"],
  "created_at": "2024-01-10T08:00:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}

​
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.
​
404
error
Not Found - managed runner with the specified ID does not exist or is not available to your tier.

​
Notes

  • Only active managed runners are accessible
  • Managed runners are maintained by ComfyControl with guaranteed uptime