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

# API Reference

> Complete reference for the ComfyControl API

## Overview

The ComfyControl API provides programmatic access to manage ComfyUI runners, execute workflows, and organize templates. Built on RESTful principles, the API uses JSON for request and response bodies (except for file uploads which use multipart/form-data).

## Base URL

All API requests should be made to:

```
https://api.comfycontrol.app
```

## API Conventions

### HTTP Methods

The API uses standard HTTP methods:

* `GET` - Retrieve resources
* `POST` - Create new resources or trigger actions
* `PUT` - Update existing resources
* `DELETE` - Remove resources

### Response Format

All responses are returned in JSON format with appropriate HTTP status codes. Successful responses return the requested data, while errors return a standardized error object.

### Timestamps

All timestamps are returned in ISO 8601 format (UTC):

```json theme={null}
"2024-01-15T10:30:00Z"
```

### UUIDs

Resource identifiers use UUID v4 format:

```json theme={null}
"550e8400-e29b-41d4-a716-446655440000"
```

## Pagination

List endpoints support pagination through query parameters:

* `page` - Page number (default: 1, minimum: 1)
* `per_page` - Items per page (default: 10, minimum: 1, maximum: 100)

**Example Request:**

```bash theme={null}
GET /v1/runner?page=2&per_page=20
```

**Response Format:**

```json theme={null}
{
  "runners": [...],
  "total": 45
}
```

## File Uploads

Endpoints that accept file uploads use `multipart/form-data` encoding:

* Maximum file size: 50MB per request
* Supported for workflows and templates
* Files are temporarily stored and processed asynchronously

## Tags

Many resources support tags for organization and filtering:

* Tags are arrays of strings
* Used for runner selection in workflows
* Case-sensitive
* No special characters required

**Example:**

```json theme={null}
{
  "tags": ["production", "gpu-a100", "image-generation"]
}
```

## Getting Started

1. [Obtain an API token](/api/authentication) from your dashboard
2. Include the token in your request headers
3. Start making API calls to manage your resources

## Need Help?

* Check the [Authentication](/api/authentication) guide to get started
* Review [Error Codes](/api/errors) for troubleshooting
* Explore [Concepts](/concepts/runners) to understand core features
* Contact support at [support@comfycontrol.app](mailto:support@comfycontrol.app)