github.deployment

Handles GitHub App deployment webhooks (DAG)

DAG-based GitHub deployment workflow.

Handles GitHub App deployment webhooks for audit logging. No model is created since deployments 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_deployment	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.deployment-validate	—
2	sync_deployment	github.deployment-sync	—
3	complete	github.deployment-complete	—

Execution Flow

Sub-workflows

Sub-workflow	Step name
github.deployment-validate	validate
github.deployment-sync	sync_deployment
github.deployment-complete	complete

Business Errors

Code	Message Template
DELIVERY_ID_REQUIRED	delivery_ref is required
DEPLOYMENT_ID_REQUIRED	deployment.id not found in payload

API Usage

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

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