Query Completion Webhook

{
  "query": "<string>",
  "trace_id": "<string>",
  "savings": 123,
  "duration_ms": 123
}

WEBHOOK

query

completed

{
  "query": "<string>",
  "trace_id": "<string>",
  "savings": 123,
  "duration_ms": 123
}

Isofold can send a webhook to your system after each query completes execution. This is useful for:

Tracking per-query savings
Auditing rewritten queries
Updating internal cost dashboards

Trigger

The webhook fires after:

A query is received via /query
It is rewritten (if possible)
It has finished executing

Payload

{
  "query": "SELECT * FROM users",
  "trace_id": "abc123",
  "savings": 0.18,
  "duration_ms": 114
}

Fields

Field	Type	Description
`query`	string	The original query submitted
`trace_id`	string	The unique identifier for this query run
`savings`	number	Estimated USD savings from optimization
`duration_ms`	number	Time taken to execute the query

Setup

To enable this webhook:

Go to the Team Settings in the Isofold Dashboard
Add your webhook endpoint URL
Optionally include an HMAC signing secret

Webhook retries on failure with exponential backoff.

Security

Webhooks include an X-Isofold-Signature header
You can verify integrity with your shared secret using HMAC-SHA256

X-Isofold-Signature: t=1699987200,v1=abc123...

Want to listen for failed or skipped queries too? Contact support@isofold.com.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

query

string

trace_id

string

savings

number

duration_ms

number

Response

200

Webhook accepted

Estimate Cost

API

Endpoints

Query Completion Webhook

Trigger

Payload

Fields

Setup

Security

Authorizations

Body

Response

​Trigger

​Payload

​Fields

​Setup

​Security

Authorizations

Body

Response

Trigger

Payload

Fields

Setup

Security