> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfycontrol.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Runner History

> Retrieve workflow execution history for a runner

## 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

<ParamField path="id" type="string" required>
  The unique identifier (UUID) of the runner to query.
</ParamField>

## Response

Returns an array of workflow objects executed on this runner.

<ResponseField name="[].id" type="string" required>
  Unique identifier (UUID) for the workflow.
</ResponseField>

<ResponseField name="[].name" type="string" required>
  The workflow's name.
</ResponseField>

<ResponseField name="[].status" type="string" required>
  Current status of the workflow.

  Possible values: `accepted`, `uploaded`, `queued`, `running`, `completed`, `cancelled`, `invalid`, `failed`
</ResponseField>

<ResponseField name="[].tags" type="string[]" required>
  Array of tags associated with the workflow.
</ResponseField>

<ResponseField name="[].created_at" type="string" required>
  ISO 8601 timestamp when the workflow was created.
</ResponseField>

<ResponseField name="[].updated_at" type="string" required>
  ISO 8601 timestamp when the workflow was last updated.
</ResponseField>

<ResponseField name="[].started_at" type="string">
  ISO 8601 timestamp when the workflow execution started (null if not yet started).
</ResponseField>

<ResponseField name="[].completed_at" type="string">
  ISO 8601 timestamp when the workflow execution completed (null if not yet completed).
</ResponseField>

## Example Response

```json theme={null}
[
  {
    "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

<ResponseField name="401" type="error">
  Unauthorized - invalid or missing authentication token.
</ResponseField>

<ResponseField name="404" type="error">
  Not Found - runner with the specified ID does not exist or does not belong to your account.
</ResponseField>

## 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