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

​
Overview

Retrieve a list of your workflows that have been executed on a specific managed runner. Returns the most recent 10 workflows by default, ordered by creation date (newest first).
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 query.

​
Response

Returns an array of workflow objects executed on this managed runner.
​
[].id
string
required
Unique identifier (UUID) for the workflow.
​
[].name
string
required
The workflow’s name.
​
[].status
string
required
Current status of the workflow.Possible values: accepted, uploaded, queued, running, completed, cancelled, invalid, failed
​
[].tags
string[]
required
Array of tags associated with the workflow.
​
[].created_at
string
required
ISO 8601 timestamp when the workflow was created.
​
[].updated_at
string
required
ISO 8601 timestamp when the workflow was last updated.
​
[].started_at
string
ISO 8601 timestamp when the workflow execution started (null if not yet started).
​
[].completed_at
string
ISO 8601 timestamp when the workflow execution completed (null if not yet completed).

​
Example Response

[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "High-Res Image Generation",
    "status": "completed",
    "tags": ["managed", "production", "text2img"],
    "created_at": "2024-01-15T14:30:00Z",
    "updated_at": "2024-01-15T14:31:45Z",
    "started_at": "2024-01-15T14:30:02Z",
    "completed_at": "2024-01-15T14:31:45Z"
  },
  {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "name": "Video Frame Interpolation",
    "status": "running",
    "tags": ["managed", "video", "interpolation"],
    "created_at": "2024-01-15T14:20:00Z",
    "updated_at": "2024-01-15T14:25:30Z",
    "started_at": "2024-01-15T14:20:15Z",
    "completed_at": null
  },
  {
    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "name": "Batch Upscaling Job",
    "status": "completed",
    "tags": ["managed", "upscale", "batch"],
    "created_at": "2024-01-15T13:45:00Z",
    "updated_at": "2024-01-15T14:10:00Z",
    "started_at": "2024-01-15T13:45:20Z",
    "completed_at": "2024-01-15T14:10: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

  • Returns a maximum of 10 most recent workflows
  • Results are ordered by creation date (newest first)
  • Only includes your workflows executed on this managed runner
  • Empty array is returned if you haven’t executed any workflows on this runner