v51

latestOpenAPI 3.0.0GPL-3.0raw.githubusercontent.com2026-08-01199241439.9 KB

webhooks

Configure webhook HMAC

Updates the webhook HMAC auth mode or enforcement mode without rotating the secret. If enforcementMode is omitted, the current enforcement mode is preserved for token_and_hmac, while hmac_only always uses strict. Developer, manager, or admin only.

post/dags/{fileName}/webhook/hmac/configure

Path parameters

fileNamestring regex required

Name of the DAG file

the name of the DAG file

Query parameters

remoteNodestring

name of the remote node

Request body

authMode'token_and_hmac' | 'hmac_only' required

enforcementMode'strict' | 'observe'

How HMAC validation is enforced when HMAC is enabled

Response

Webhook HMAC updated successfully

idstring uuid required

Unique identifier for the webhook

dagNamestring required

Name of the DAG this webhook triggers

tokenPrefixstring required

First 8 characters of the token for identification

enabledboolean required

Whether the webhook is active

authMode'token_only' | 'token_and_hmac' | 'hmac_only' required

Authentication mode for a webhook trigger endpoint

createdAtstring date-time required

When the webhook was created

updatedAtstring date-time required

When the webhook was last modified

createdBystring

User ID who created the webhook

lastUsedAtstring date-time

When the webhook was last triggered