data.runner.get-execution

Get a runner execution by uuid

Return a single runner execution by UUID.

Overview

Property	Value
Workflow type	Atomic
Library	App-runners
Version	1.0

Input Schema

Field	Type	Required	Default	Description
organization_uuid	uuid	Yes	—	UUID of the caller's organization, injected server-side from the authenticated request; scopes the operation to the correct tenant.
runner_execution_uuid	uuid	Yes	—	UUID of the RunnerExecution to fetch, picked from the organization's (optionally group-scoped) list of executions.

Output Schema

Field	Type	Required	Default	Description
uuid	uuid	No	—	—
runner_group_uuid	uuid	No	—	UUID of the RunnerGroup this execution belongs to, echoed from the execution's parent group; picked from the organization's list of runner groups.
organization_uuid	uuid	No	—	Organization UUID echoed from input.
workflow_uuid	string	No	—	Engine workflow-run identifier associated with this execution (or, on some records, an external GitHub Actions run id); not a platform entity foreign key despite the name. System-generated, no user default needed.
status	string	No	—	—
backend_type	string	No	—	—
launch_type	string	No	—	—
ecs_cluster_arn	string	No	—	—
task_arn	string	No	—	—
task_definition_arn	string	No	—	—
log_group_name	string	No	—	—
log_stream_name	string	No	—	—
github_runner_ref	integer	No	—	—
github_runner_name	string	No	—	—
exit_code	integer	No	—	—
stop_reason	string	No	—	—
failure_category	string	No	—	—
failure_details	dict	No	—	—
runner_instance_uuid	uuid	No	—	—
workspace_lease_uuid	uuid	No	—	—
agent_session_uuid	uuid	No	—	—
ticket_git_work_uuid	uuid	No	—	—
operator_stage	string	No	—	—
terminal_outcome	string	No	—	—
blocker	dict	No	—	—
retry_request	dict	No	—	—
claim_watch	dict	No	—	—
started_at	string	No	—	—
registered_at	string	No	—	—
stopped_at	string	No	—	—
last_synced_at	string	No	—	—
created_at	string	No	—	—
found	boolean	No	—	False when the requested record was not found.
error	string	No	—	—
error_type	string	No	—	—

States

State	Initial	Terminal	Success	Auto-advance	Description
done	Yes	Yes	Yes	—	—

API Usage

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "data.runner.get-execution",
  "initial_data": {
    "organization_uuid": "value",
    "runner_execution_uuid": "value"
  }
}