GET
/
v2
/
runs
/
{workflow_run_id}
curl --request GET \
  --url https://api.workflows.tryleap.ai/v2/runs/{workflow_run_id} \
  --header 'X-Api-Key: <api-key>'
{
  "id": "<string>",
  "version_id": "<string>",
  "workflow_id": "<string>",
  "status": "completed",
  "created_at": "<string>",
  "error": null,
  "result": null
}

This endpoint retrieves both the current status and output data of a workflow run. The status indicates whether the workflow is still running, has completed successfully, or encountered an error.

To monitor a workflow’s progress, the recommended pattern is to:

  1. Call this endpoint periodically (e.g., every 3-5 seconds)
  2. Check the status field in the response
  3. Once status shows “completed”, retrieve the workflow output from the response data

Authorizations

​
X-Api-Key
string
header
required

Path Parameters

​
workflow_run_id
string
required

The ID of the workflow run to retrieve.

Example:

"runv2_8R8jNYkpBVLI4FqCJiJ5"

Response

200
application/json
The workflow run details have been successfully retrieved.
​
id
string
required
​
version_id
string
required
​
workflow_id
string
required
​
status
enum<string>
required
Available options:
completed,
running,
failed,
queued,
cancelled
​
created_at
string
required
​
error
string | null
required
​
result
object | null
required