Buni.aiDocs
API referenceInvocations

Async run callback

Sent to your webhookUrl when an async run finishes.

Sent to your webhookUrl when an async run finishes. The URL comes from the request's webhookUrl, else the Trigger node's callback override, else the project's Default callback URL.

  • https only; private, loopback and link-local addresses are refused, and redirects are not followed.
  • When a secret is set (webhookSecret, the node's callback secret, or Default callback secret), the X-BuniAI-Signature header carries the hex HMAC-SHA256 of the raw request body, keyed with that secret. There is no sha256= prefix and no timestamp.
  • Any 2xx response counts as delivered. Otherwise the call is retried up to 3 attempts in total, waiting 0.5 s and then 1 s, with a 10 s timeout per attempt.

Use invocationId to de-duplicate: a retried delivery carries the same body.

Header Parameters

X-BuniAI-Signature?string

Hex-encoded HMAC-SHA256 of the raw body. Present only when a callback secret is configured.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

Example Requests

POST/runCallback