Sign in
workflow

Get full job details

Retrieve complete details for a specific job including workflow and outputs. Used for detail views, workflow re-execution, and debugging.

get/api/jobs/{job_id}

Path parameters

job_idstring uuid required

Job identifier (UUID)

Query parameters

short_link'ephemeral_tool_chain' | 'default'

When present, each output item in the response receives a short_url field containing a short link for that asset. Omit this parameter (the default) to receive a response identical to the no-param baseline. The value selects the link's lifetime and auth model: use ephemeral_tool_chain for short-lived (≤5 minute) machine-to-machine handoffs — these are public bearer links where the link ID itself is the credential, so anyone holding the link can resolve it (intended for pasting into an agent/MCP tool chain); use default for durable (30 day) human-revisitable links, which are owner-gated and resolvable only by the authenticated owner. Links are always minted under the authenticated request owner's identity; the auth model is selected by the server and is never settable by the caller.

Response

Success - Job details retrieved

create_timeinteger required

Job creation timestamp (Unix timestamp in milliseconds)

execution_end_timeinteger

Workflow execution completion timestamp (Unix milliseconds, only present for terminal states)

execution_metaobject

Node-level execution metadata (only for terminal states)

execution_start_timeinteger

Workflow execution start timestamp (Unix milliseconds, only present once execution has started)

execution_statusobject

ComfyUI execution status and timeline (only for terminal states)

idstring uuid required

Unique job identifier

outputsobject

Full outputs object from ComfyUI (only for terminal states)

outputs_countinteger

Total number of output files (omitted for non-terminal states)

preview_outputobject

Primary preview output (only for terminal states)

previewable_outputs_countinteger

Count of outputs classified as previewable media types (images, video, audio, 3D, text) — a subset of outputs_count (omitted for non-terminal states)

status'pending' | 'in_progress' | 'completed' | 'failed' | 'cancelled' required

User-friendly job status

update_timeinteger required

Last update timestamp (Unix timestamp in milliseconds)

user_idstring

ID of the user that owns this job (see the workspace_id description above for why this is always the caller's own id on a successful response).

workflowobject

Full ComfyUI workflow (10-100KB, omitted if not available).

Sensitive credentials are redacted before the response is returned: extra_data.api_key_comfy_org, when present, is replaced with the literal string "[REDACTED]". The field is preserved (not removed) so existence checks still pass, but the value is not usable.

workflow_idstring

UUID identifying the workflow graph definition

workflow_version_idstring

UUID of the cloud workflow version this job is pinned to, if the submission carried one (see PromptRequest's workflow_version_id). Absent for jobs submitted without that association, including every job submitted through the public API v2 today.

workspace_idstring

ID of the workspace that owns this job. A successful (200) response from this operation is only ever returned for the caller's own job (see this operation's ownership-scoped query), so this is always the caller's own workspace — consumers that also need to correlate this job to its live-progress broadcast channel (workspace+user scoped; see the internal common/gateways/broadcast package) can use this value directly rather than resolving their own identity a second way.

Changes

Changed in 7 of the 38 revisions of this API.71642

  • da017caf56f12See the full diff
    • ○

      added the optional property previewable_outputs_count to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property workflow_version_id to the response with the 200 status

      response-optional-property-added

  • 9fb6092a836d4See the full diff
    • ○

      added the optional property execution_end_time to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property execution_start_time to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property user_id to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property workspace_id to the response with the 200 status

      response-optional-property-added

  • 8af4304e9fb01See the full diff
    • ○

      added the new optional query request parameter short_link

      new-optional-request-parameter

  • 8560879e61881910See the full diff
    • ▲

      the execution_error response's property type/format changed from object/ to / for status 200

      response-property-type-changed

    • ●

      removed the optional property execution_end_time from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property execution_error/current_inputs from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property execution_error/current_outputs from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property execution_error/exception_message from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property execution_error/exception_type from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property execution_error/node_id from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property execution_error/node_type from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property execution_error/traceback from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property execution_start_time from the response with the 200 status

      response-optional-property-removed

    • ○

      api tag workflow added

      api-tag-added

    • ○

      api tag queue removed

      api-tag-removed

    • ○

      added the media type application/json for the response with the status 404

      response-media-type-added

    • ○

      added the optional property details to the response with the 401 status

      response-optional-property-added

    • ○

      added the optional property details to the response with the 403 status

      response-optional-property-added

    • ○

      added the optional property details to the response with the 500 status

      response-optional-property-added

    • ○

      added the optional property workflow_id to the response with the 200 status

      response-optional-property-added

    • ○

      added ExecutionError to the execution_error response property allOf list for the response status 200

      response-property-all-of-added

    • ○

      the response property create_time became required for the status 200

      response-property-became-required

    • ○

      the response property update_time became required for the status 200

      response-property-became-required

    This revision also has 130 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 8eec9009e0035See the full diff
    • ●

      added the new cancelled enum value to the status response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new completed enum value to the status response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new failed enum value to the status response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new in_progress enum value to the status response property for the response status 200

      response-property-enum-value-added

    • ●

      added the new pending enum value to the status response property for the response status 200

      response-property-enum-value-added

  • 09a5075587c84See the full diff
    • ○

      api operation id getJob removed and replaced with getJobDetail

      api-operation-id-removed

    • ○

      added the non-success response with the status 401

      response-non-success-status-added

    • ○

      added the non-success response with the status 403

      response-non-success-status-added

    • ○

      added the non-success response with the status 500

      response-non-success-status-added

  • a66055fa384e6221See the full diff
    • ▲

      removed the media type application/json for the response with the status 404

      response-media-type-removed

    • ▲

      the response property create_time became optional for the status 200

      response-property-became-optional

    • ▲

      the response property update_time became optional for the status 200

      response-property-became-optional

    • ▲

      the create_time response's property type/format changed from integer/int64 to number/ for status 200

      response-property-type-changed

    • ▲

      the execution_error response's property type/format changed from / to object/ for status 200

      response-property-type-changed

    • ▲

      the update_time response's property type/format changed from integer/int64 to number/ for status 200

      response-property-type-changed

    • ●

      deleted the query request parameter short_link

      request-parameter-removed

    • ●

      removed the optional property workflow_id from the response with the 200 status

      response-optional-property-removed

    • ○

      api operation id getJobDetail removed and replaced with getJob

      api-operation-id-removed

    • ○

      api tag queue added

      api-tag-added

    • ○

      api tag workflow removed

      api-tag-removed

    • ○

      removed the non-success response with the status 401

      response-non-success-status-removed

    • ○

      removed the non-success response with the status 403

      response-non-success-status-removed

    • ○

      removed the non-success response with the status 500

      response-non-success-status-removed

    • ○

      added the optional property execution_end_time to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property execution_error/current_inputs to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property execution_error/current_outputs to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property execution_error/exception_message to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property execution_error/exception_type to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property execution_error/node_id to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property execution_error/node_type to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property execution_error/traceback to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property execution_start_time to the response with the 200 status

      response-optional-property-added

    • ○

      removed ExecutionError from the execution_error response property allOf list for the response status 200

      response-property-all-of-removed

    • ○

      removed the cancelled enum value from the status response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the completed enum value from the status response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the failed enum value from the status response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the in_progress enum value from the status response property for the response status 200

      response-property-enum-value-removed

    • ○

      removed the pending enum value from the status response property for the response status 200

      response-property-enum-value-removed

    This revision also has 36 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog