github.repository

Handles GitHub App repository webhooks (DAG)

DAG-based GitHub repository workflow.

Handles GitHub App repository webhooks with parallel-capable structure. Uses atomic workflows for step execution.

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_repository	dict	No	—	—
update_connection	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.repository-validate	—
2	sync_repository	github.repository-sync	—
3	update_cloud_connection	github.repository-update-connection	—
4	complete	github.repository-complete	—

Execution Flow

Sub-workflows

Sub-workflow	Step name
github.repository-validate	validate
github.repository-sync	sync_repository
github.repository-update-connection	update_connection
github.repository-complete	complete

Business Errors

Code	Message Template
DELIVERY_ID_REQUIRED	delivery_ref is required
REPOSITORY_ID_REQUIRED	repository.id not found in payload
INSTALLATION_NOT_FOUND	GitHub installation not found

API Usage

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

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