Skip to main content
GET
/
workflow-runs
/
{run_id}
Get Workflow Run Status
curl --request GET \
  --url https://api.curalabs.io/v1/workflow-runs/{run_id} \
  --header 'X-API-Key: <api-key>'
{
  "run_id": "wfr_ghi789jkl012",
  "workflow_id": "wf_abc123def456",
  "developer_user_id": "<string>",
  "status": "queued",
  "result": {},
  "error": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}
Retrieve the status and results of a specific workflow run. See the API Reference for details on operationId: getWorkflowRunStatus.

Authorizations

​
X-API-Key
string
header
required

API Key provided by the platform. Note- X-Timestamp and X-Signature headers are also required for authentication, but not defined as separate schemes here due to OpenAPI limitations on complex signature schemes.

Path Parameters

​
run_id
string
required

The ID of the workflow run to retrieve.

Example:

"wfr_ghi789jkl012"

Response

OK. Current status and details of the workflow run.

​
run_id
string

Unique identifier for the workflow run.

Example:

"wfr_ghi789jkl012"

​
workflow_id
string

Identifier of the workflow definition being run.

Example:

"wf_abc123def456"

​
developer_user_id
string

Identifier for the end-user the workflow was run for.

​
status
enum<string>

Current status of the workflow run.

Available options:
queued,
processing,
completed,
failed
​
result
object | null

The final result object if the run completed successfully. Structure may vary.

​
error
string | null

Error message if the run failed.

​
created_at
string<date-time>

ISO 8601 timestamp when the run was initiated.

​
updated_at
string<date-time>

ISO 8601 timestamp when the run status was last updated.

⌘I