Sign in

v36

latestOpenAPI 3.0.3GNU General Public License v3.0raw.githubusercontent.com2026-08-017758212.6 KB
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)

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

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.