Get Workflow Run
GET /api/v1/workflow-jobs/:jobId — poll a workflow run's status and result.
Reads the current state of a workflow run started by /run or /run-async.
GET /api/v1/workflow-jobs/{jobId}jobId is the executionId returned when the run was started — including the one in a 504 timeout body from the synchronous endpoint.
Not the same as /jobs/:jobId
GET /jobs/:jobId polls an agent async job. Workflow runs are a
different kind of record and live under /workflow-jobs/. Passing one endpoint's id to the other
returns 404.
Path parameters
| Parameter | Type | Description |
|---|---|---|
jobId | string (UUID) | The run's executionId. |
Response
200 OK
{
"executionId": "8f2a1c9e-...",
"workflowId": "3f9c1a2e-...",
"status": "running",
"startedAt": 1732550125,
"completedAt": null,
"error": null
}| Field | Type | Description |
|---|---|---|
executionId | string (UUID) | The run's id. |
workflowId | string (UUID) | The workflow it belongs to. |
status | string | See the status table on /run-async. |
startedAt | number | null | Unix seconds when the engine picked the run up. null while it is still queued. |
completedAt | number | null | Unix seconds when the run reached a terminal state, else null. |
error | string | null | Why the run failed, or why it was rejected pre-flight. null otherwise. |
No output field, and no createdAt
This endpoint reports a run's status, not its result. A run's output — the output of
whichever node(s) terminated the executed graph — is returned only by the synchronous
/run endpoint; per-node outputs for a completed run are
visible in Studio's Activity tab. There is also no createdAt — a workflow run records when it
started, and startedAt: null is itself the honest answer to "has it begun yet".
Errors
| Status | error | When |
|---|---|---|
404 | job_not_found | No run with that id in your organization, or outside your project-scoped key's project |
A run in another organization — or, for a project-scoped key, another project — returns 404 rather than 403, so run ids cannot be enumerated by status code.
Example
curl https://api.elizon.com/api/v1/workflow-jobs/{executionId} \
-H "X-API-Key: elz_your_key_here"