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

# Comfy API v2 Overview

<Warning>
  **Beta:** Comfy API v2 is at `0.1.x` and the surface may still change. Changes within v2 will be additive; anything breaking would ship as v3.
</Warning>

The official, versioned HTTP API for running ComfyUI workflows from external applications: upload inputs, submit a workflow, observe execution, retrieve results.

Most people should start with the [Comfy SDKs](/development/api-development/sdks), which wrap this API in Python and TypeScript. Call these endpoints directly if you are working in another language.

## Design Principles

* **Poll first.** Every capability is reachable via plain GET polling. The SSE stream is a live enhancement, never the source of truth.
* **Everything is resumable.** Submission is idempotent, and job state and outputs are retrievable by ID until `expires_at`.
* **Content-addressed assets.** Assets are UUID-identified records over blobs keyed by a server-computed blake3 hash, so identical inputs are not uploaded twice.
* **Follow links, do not build URLs.** Responses embed their follow-up URLs.

See [Design Notes](/development/api-development/sdks-design) for the reasoning behind these.

## Base URLs

| Surface                                                                          | URL                       | Authentication                                |
| -------------------------------------------------------------------------------- | ------------------------- | --------------------------------------------- |
| Comfy Cloud                                                                      | `https://cloud.comfy.org` | `Authorization: Bearer <api-key>`             |
| Self-hosted, via [comfy-api-proxy](https://github.com/Comfy-Org/comfy-api-proxy) | `http://127.0.0.1:8189`   | None by default, optional static bearer token |

## Endpoint Categories

| Category | Description                                                                            |
| -------- | -------------------------------------------------------------------------------------- |
| Assets   | UUID-identified records over content-addressed blobs. Upload inputs, download outputs. |
| Jobs     | One execution of a workflow. Durable, pollable, and cancelable.                        |