Webhooks


POST /{o}/{p}/webhooks/github

Receive a GitHub pull_request webhook

HMAC-authenticated (X-Hub-Signature-256, keyed on the per-action webhook secret). Transitions the matching pull-request ActionRun on PR close (merged → succeeded, closed → failed). Unmatched/unsigned events are silently acknowledged. No Bearer token.

Auth: HMAC-SHA256 signature (X-Hub-Signature-256 header) · Webhook self-auth — no Bearer token.

Path parameters

NameTypeDescription
ostring
pstring

Request body (application/json)

FieldTypeDescription
actionstring(required)
repositoryobject(required)
pull_requestobject

Responses

StatusDescriptionSchema
200AcknowledgedWebhookAck
400Invalid or malformed payloadError
401Invalid HMAC signatureError

POST /webhooks/github

Receive GitHub App webhook events

HMAC-authenticated (X-Hub-Signature-256, keyed on the GitHub App webhook secret). Dispatches installation/repo lifecycle events. No Bearer token.

Auth: HMAC-SHA256 signature (X-Hub-Signature-256 header) · Webhook self-auth — no Bearer token.

Responses

StatusDescriptionSchema
200DispatchedGitHubWebhookOutcome
400Invalid JSONError
401Invalid HMAC signatureError
503GitHub App not configuredError

Schemas

Error

FieldTypeDescription
errorstring(required)
codestring

GitHubWebhookOutcome

FieldTypeDescription
oktrue(required)
outcomeobject

WebhookAck

FieldTypeDescription
oktrue(required)