Webhooks are now stable

Webhooks are out of beta. The API is stable and ready for production. See the webhooks guide to get started.

When you create a prediction, include a webhook object with a url and an optional secret. WriftAI sends a POST request to that URL each time there is an update. Your endpoint needs to respond with a 2xx status code.

Since prediction data is deleted a little after a prediction completes as per our data retention policy, webhooks are the standard way to capture and persist outputs without polling.

Verifying requests

If you set a secret, WriftAI signs every delivery with HMAC-SHA256. The wriftai-webhook-signature header contains the timestamp and signature as t=timestamp,v1=signature. The official SDKs including Python, JavaScript, and Go have helpers that handle verification automatically. See the verification guide for implementation details.