github.check

Handles GitHub App check webhooks (DAG)

DAG-based GitHub check workflow.

Handles GitHub App check_run and check_suite webhooks for audit logging. No model is created since checks are informational only.

Overview

Property	Value
Workflow type	Dag
Library	App-github
Version	1.0

Input Schema

Field	Type	Required	Default	Description
delivery_ref	string	Yes	—	Webhook delivery ID
event_type	string	Yes	—	Webhook event type
action	string	Yes	—	Webhook action
payload	dict	Yes	—	Webhook payload
organization_uuid	string	No	—	Organization UUID (public)

Output Schema

Field	Type	Required	Default	Description
delivery_ref	string	No	—	—
event_type	string	No	—	—
action	string	No	—	—
payload	dict	No	—	—
organization_uuid	string	No	—	—
workflow_run_uuid	string	No	—	—
validate	dict	No	—	—
sync_check	dict	No	—	—
complete	dict	No	—	—
failure_reason	string	No	—	—
failure_type	string	No	—	—
failed_action	string	No	—	—
failed_at_state	string	No	—	—
failed_step	string	No	—	—
failed_layer	integer	No	—	—
error	string	No	—	—
error_type	string	No	—	—

DAG Layers

#	Layer	Steps	Compensation
1	validate	github.check-validate	—
2	sync_check	github.check-sync	—
3	complete	github.check-complete	—

Execution Flow

Sub-workflows

Sub-workflow	Step name
github.check-validate	validate
github.check-sync	sync_check
github.check-complete	complete

Business Errors

Code	Message Template
DELIVERY_ID_REQUIRED	delivery_ref is required
CHECK_ID_REQUIRED	check_run or check_suite id not found in payload

API Usage

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

{
  "workflow_type": "github.check",
  "initial_data": {
    "delivery_ref": "value",
    "event_type": "value",
    "action": "value",
    "payload": "value"
  }
}