Chat Completion Events

View as Markdown
Sent by the Apologist Agent platform to your configured webhook URL whenever a subscribed agent event occurs. Your endpoint must respond with any 2xx status to acknowledge; non-2xx responses are logged and are **not** retried. Verify the request before trusting it. Two security modes are supported per notification: - **Signature mode** (recommended): `X-Webhook-Signature` carries `sha256=<hex>`, the HMAC-SHA256 of `"{X-Webhook-Timestamp}.{rawBody}"` keyed by your secret. Reject stale timestamps and compare in constant time. - **Shared-secret mode**: `X-Webhook-Secret` carries the plaintext secret to compare against your stored value. See WEBHOOKS.md for full verification examples.