Job

GET

/api/jobs/{prompt_id}

curl --request GET \
  --url https://example.com/api/jobs/example \
  --header 'Authorization: Bearer <token>'

Get status, outputs and provenance for a single job, reconciled live against its node.

While its node doesn’t answer, a job keeps its last status with node_unreachable true. When the node answers again and has no record of the job (a restarted ComfyUI loses its queue), the job is marked failed.

Authorizations

• bearerAuth

Parameters

Path Parameters

prompt_id

required

Prompt Id

string

Responses

200

Successful Response

Media typeapplication/json

JobStatusResponse

Status, outputs, and what made them.

The provenance fields let an agent answer “do that again but …” from a bare prompt_id, without asking its human for the workflow, model, seed or params. They are null while a job is still queued on a node that never accepted it.

object

ok

required

Ok

boolean

prompt_id

required

Prompt Id

string

status

required

Status

string

progress

Any of:

number

number

null

null

queue_position

Any of:

integer

integer

null

null

outputs_count

Any of:

integer

integer

null

null

outputs

Outputs

Array<object>

default:

JobOutput

object

type

required

Type

string

filename

required

Filename

string

subfolder

Subfolder

string

""

folder_type

Folder Type

string

default: output

url

required

Url

string

raw

Any of:

object

object

key

additional properties

any

null

null

node_unreachable

Node Unreachable

The job’s node didn’t answer; status is the last one known

boolean

workflow

Any of:

string

string

null

null

provider

Any of:

string

string

null

null

prompt

Any of:

string

string

null

null

negative_prompt

Any of:

string

string

null

null

image

Any of:

string

string

null

null

models

Models

Array<string>

default:

loras

Loras

Array<string>

default:

seed

Any of:

integer

integer

null

null

width

Any of:

integer

integer

null

null

height

Any of:

integer

integer

null

null

workflow_params

Any of:

object

object

key

additional properties

any

null

null

settings

Settings

object

key

additional properties

any

error

Any of:

string

string

null

null

started_at

Any of:

string

string format: date-time

null

null

finished_at

Any of:

string

string format: date-time

null

null

Example

{
  "outputs": [],
  "node_unreachable": false,
  "models": [],
  "loras": [],
  "settings": {}
}

422

Validation Error

Media typeapplication/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

Example^generated

{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}