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

> Retrieve details of a specific runner

## Overview

Retrieve detailed information about a specific runner by its ID. Only returns runners that belong to your account.

## Path Parameters

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

## Response

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

<ResponseField name="user_id" type="string" required>
  UUID of the user who owns this runner.
</ResponseField>

<ResponseField name="name" type="string" required>
  The runner's name.
</ResponseField>

<ResponseField name="status" type="string" required>
  Current status of the runner. Values: `active`, `disabled`
</ResponseField>

<ResponseField name="endpoint" type="string" required>
  The URL where the runner is accessible.
</ResponseField>

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

<ResponseField name="headers" type="object" required>
  Custom headers configured for this runner.
</ResponseField>

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

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

## Example Response

```json theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "name": "Production GPU Runner",
  "status": "active",
  "endpoint": "https://my-comfy.example.com",
  "tags": ["production", "gpu-a100", "image-generation"],
  "headers": {
    "Authorization": "Bearer secret_token",
    "X-Custom-Header": "value"
  },
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}
```

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