github.pull_request

Handles GitHub App pull_request webhooks (DAG)

DAG-based GitHub pull_request workflow.

Handles GitHub App pull_request webhooks for audit logging. No model is created since PRs 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_pr	dict	No	—	—
dispatch_staff_event	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.pull_request-validate	—
2	sync_pr	github.pull_request-sync	—
3	dispatch_staff_event	staff.dispatch-event-to-actor	—
4	complete	github.pull_request-complete	—

Execution Flow

Sub-workflows

Sub-workflow	Step name
github.pull_request-validate	validate
github.pull_request-sync	sync_pr
staff.dispatch-event-to-actor	dispatch_staff_event
github.pull_request-complete	complete

Business Errors

Code	Message Template
DELIVERY_ID_REQUIRED	delivery_ref is required
PR_ID_REQUIRED	pull_request.id not found in payload

API Usage

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

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