Skip to main content
GET
https://api.comfycontrol.app
/
v1
/
runner
/
{id}
/
history
Get Runner History
curl --request GET \
  --url https://api.comfycontrol.app/v1/runner/{id}/history \
  --header 'Authorization: Bearer <token>'
{
  "401": {},
  "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 workflows that have been executed on a specific runner. Returns the most recent 10 workflows by default, ordered by creation date (newest first).

​
Path Parameters

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

​
Response

Returns an array of workflow objects executed on this 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": "Text to Image Generation",
    "status": "completed",
    "tags": ["text2img", "production"],
    "created_at": "2024-01-15T14:30:00Z",
    "updated_at": "2024-01-15T14:32:15Z",
    "started_at": "2024-01-15T14:30:05Z",
    "completed_at": "2024-01-15T14:32:15Z"
  },
  {
    "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "name": "Image Upscaling",
    "status": "failed",
    "tags": ["upscale", "production"],
    "created_at": "2024-01-15T13:15:00Z",
    "updated_at": "2024-01-15T13:16:30Z",
    "started_at": "2024-01-15T13:15:10Z",
    "completed_at": "2024-01-15T13:16:30Z"
  },
  {
    "id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
    "name": "ControlNet Test",
    "status": "running",
    "tags": ["controlnet", "test"],
    "created_at": "2024-01-15T12:00:00Z",
    "updated_at": "2024-01-15T12:01:45Z",
    "started_at": "2024-01-15T12:00:20Z",
    "completed_at": null
  }
]

​
Error Responses

​
401
error
Unauthorized - invalid or missing authentication token.
​
404
error
Not Found - runner with the specified ID does not exist or does not belong to your account.

​
Notes

  • Returns a maximum of 10 most recent workflows
  • Results are ordered by creation date (newest first)
  • Only includes workflows executed on this specific runner