Skip to main content
GET
/
v1
/
workflow
/
{id}
Get Workflow
curl --request GET \
  --url https://api.comfycontrol.app/v1/workflow/{id} \
  --header 'Authorization: Bearer <token>'
{
  "401": {},
  "404": {},
  "id": "<string>",
  "user_id": "<string>",
  "name": "<string>",
  "status": "<string>",
  "user_runner_id": "<string>",
  "managed_runner_id": "<string>",
  "tags": [
    "<string>"
  ],
  "workflow_json": {},
  "workflow_params": [
    {}
  ],
  "prompt_id": "<string>",
  "queue_number": 123,
  "error_node": "<string>",
  "exception_type": "<string>",
  "exception_message": "<string>",
  "created_at": "<string>",
  "updated_at": "<string>",
  "started_at": "<string>",
  "completed_at": "<string>"
}

​
Overview

Retrieve complete details about a specific workflow by its ID, including execution status, parameters, and error information if applicable.

​
Path Parameters

​
id
string
required
The unique identifier (UUID) of the workflow to retrieve.

​
Response

​
id
string
required
Unique identifier (UUID) for the workflow.
​
user_id
string
required
UUID of the user who owns this 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
​
user_runner_id
string
UUID of the user-owned runner executing this workflow (null if using managed runner).
​
managed_runner_id
string
UUID of the managed runner executing this workflow (null if using user-owned runner).
​
tags
string[]
required
Array of tags associated with the workflow.
​
workflow_json
object
required
The ComfyUI workflow definition as a JSON object.
​
workflow_params
array
required
Array of parameter tuples [parameter_name, parameter_value] used in this workflow execution.
​
prompt_id
string
ComfyUI prompt ID assigned when the workflow is queued (null if not yet queued).
​
queue_number
integer
Position in the runner’s execution queue (null if not yet queued).
​
error_node
string
The ComfyUI node that caused the failure (only present if status is failed).
​
exception_type
string
Type of exception that occurred (only present if status is failed).
​
exception_message
string
Detailed error message (only present if status is failed).
​
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 execution started (null if not yet started).
​
completed_at
string
ISO 8601 timestamp when execution completed (null if not yet completed).

​
Example Response (Completed)

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "name": "Text to Image Generation",
  "status": "completed",
  "user_runner_id": "550e8400-e29b-41d4-a716-446655440000",
  "managed_runner_id": null,
  "tags": ["production", "text2img"],
  "workflow_json": {
    "nodes": [...],
    "links": [...],
    "config": {...}
  },
  "workflow_params": [
    ["$text(prompt)", "A beautiful sunset over mountains"],
    ["#choice(sampler)", "euler_ancestral"]
  ],
  "prompt_id": "8f3a9c2b-1234-5678-9abc-def012345678",
  "queue_number": 1,
  "error_node": null,
  "exception_type": null,
  "exception_message": null,
  "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"
}

​
Example Response (Failed)

{
  "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "user_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "name": "Image Upscaling",
  "status": "failed",
  "user_runner_id": null,
  "managed_runner_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "tags": ["upscale"],
  "workflow_json": {...},
  "workflow_params": [
    ["$file(input_image)", "inputs/b2c3d4e5-f6a7-8901/image.png"]
  ],
  "prompt_id": "9g4b0d3c-2345-6789-0bcd-ef123456789a",
  "queue_number": 2,
  "error_node": "UpscaleModelLoader",
  "exception_type": "FileNotFoundError",
  "exception_message": "Model file 'RealESRGAN_x4.pth' not found",
  "created_at": "2024-01-15T14:20:00Z",
  "updated_at": "2024-01-15T14:21:30Z",
  "started_at": "2024-01-15T14:20:10Z",
  "completed_at": "2024-01-15T14:21:30Z"
}

​
Error Responses

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

​
Notes

  • Use this endpoint to get complete workflow details including execution parameters
  • Error information is only present when status is failed
  • Either user_runner_id or managed_runner_id will be set, never both
  • The workflow_json contains the full ComfyUI workflow definition
  • Parameter values in workflow_params show the actual values used, including file paths for uploaded files
  • Use the subscribe endpoint for real-time status updates instead of polling this endpoint
  • Queue position updates as other workflows complete