Webhooks
Webhook events
Understand every event currently emitted by the PrompTessor public platform.
Verified against the implementation ·
Event envelope
{
"id": "evt_...",
"object": "event",
"event": "operation.succeeded",
"createdAt": "2026-09-07T12:34:56.000Z",
"data": {}
}The data object depends on the event. Persist unknown fields and tolerate additive fields so your receiver remains forward-compatible.
Event catalog
| Event | When it is emitted |
|---|---|
| operation.succeeded | A credit-consuming REST or MCP AI operation completes successfully |
| operation.failed | A started AI operation fails; reserved usage is released |
| operation.cancelled | A pending asynchronous operation is cancelled |
| usage.threshold_reached | Monthly usage reaches the 80% threshold |
| usage.exhausted | Monthly usage is at its limit and add-on balance is zero |
| addon_usage.low | The remaining add-on balance reaches 10 |
| library.item.published | An owned Prompt Library item is published to Community Prompts |
| webhook.test | A one-off endpoint test is requested; this event is sent only to that endpoint and is not a subscription option |
At-least-once delivery
A delivery may be attempted more than once. Treat event handlers as idempotent and never assume chronological arrival across different endpoints.