Docs

Webhooks

Set a default webhook URL in the console (Settings), or pass webhook_url per job. We POST:

{ "type": "transcription.job.completed", "data": { "job": { "id": "trj_…", "status": "completed", "units": "2730.000" } } }

Types: transcription.job.completed, transcription.job.failed.

Verify the signature

Every delivery carries Pool-Signature: t=<unix seconds>,v1=<hex>. Compute HMAC-SHA256(secret, "<t>.<raw body>") with your webhook secret and compare in constant time. Reject timestamps older than 5 minutes.

import hmac, hashlib, time

def verify(secret: bytes, header: str, body: bytes) -> bool:
    parts = dict(p.split("=", 1) for p in header.split(","))
    if abs(time.time() - int(parts["t"])) > 300:
        return False
    mac = hmac.new(secret, f"{parts['t']}.".encode() + body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(mac, parts["v1"])

Deliveries are retried for up to 24 hours. The URL must be public https (same rules as job URLs).

Webhooks · Vouch Compute