POST
/
run
/
queue
curl --request POST \
  --url https://api.comfydeploy.com/api/run/queue \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "inputs": {
    "prompt": "A beautiful landscape",
    "seed": 42
  },
  "webhook": "<string>",
  "webhook_intermediate_status": true,
  "gpu": "T4",
  "workflow_version_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "machine_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}'
{
  "run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
workflow_version_id
string
required
inputs
object

The inputs to the workflow

Example:
{
  "prompt": "A beautiful landscape",
  "seed": 42
}
webhook
string
webhook_intermediate_status
boolean
default:false
Example:

true

gpu
enum<string>

The GPU to override the machine's default GPU

Available options:
T4,
L4,
A10G,
A100,
A100-80GB,
H100
machine_id
string | null

Response

200
application/json
Successful Response
run_id
string
required

The ID of the run, use this to get the run status and outputs