submit_request
Destructive
Submit an async inference request to a ComfyUI deployment with node overrides, file inputs, webhooks, and optional synchronous completion.
Instructions
Submit an async inference request to a deployment.
Backs ``POST /prod/v1/deployments/{deployment_id}/inference``.
Args:
deployment_id: Target deployment.
overrides: Partial graph keyed by node_id, e.g.
``{"6": {"inputs": {"text": "a cat"}}}``.
Use ``get_deployment(include_payload=true)`` to discover
node IDs and input names.
workflow_api_json: Advanced — run a different workflow without
updating the deployment. Omit ``overrides`` in this mode.
extra_data: E.g. ``{"api_key_comfy_org": "comfyui-..."}`` for
ComfyUI Core API nodes.
webhook_url: Push-based updates instead of polling.
webhook_intermediate_status: Fire webhooks on every status
change, not just terminal.
wait_for_completion: If true, poll until done and return the
result inline.
timeout_seconds: Max wait when wait_for_completion=true.
File inputs: pass a public HTTPS URL or Base64 data URI directly
in the overrides value, e.g.
``{"189": {"inputs": {"image": "https://example.com/photo.jpg"}}}``
or ``{"189": {"inputs": {"image": "data:image/jpeg;base64,/9j..."}}}``.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| overrides | No | ||
| extra_data | No | ||
| webhook_url | No | ||
| deployment_id | Yes | ||
| timeout_seconds | No | ||
| workflow_api_json | No | ||
| wait_for_completion | No | ||
| webhook_intermediate_status | No |