Redeliver a missed speech-to-text webhook without rerunning the job

If your webhook receiver missed the callback for a finished Sume STT job, call POST /v1/jobs/{id}/webhook/redeliver. It re-sends the job's real terminal payload with a fresh timestamp and a sume-v1 signature, and it works even after the automatic attempts are exhausted. You do not resubmit the audio and you do not pay for a second transcription.

This is the fix for the usual 3 a.m. problem: a deploy took your endpoint down while a batch of transcripts finished.

What exactly does redeliver do?

Per the Sume OpenAPI spec, redeliver re-POSTs the terminal event, which is job.completed, job.failed or job.canceled. It requires the jobs:write permission and does not consume one of the automatic 10 retries. It returns 409 if the job is still running or was created without a webhook_url, and 404 for a job you cannot see.

What must your receiver handle?

Delivery is terminal only. There are no progress or partial callbacks, so you will see one of three event types per job. A redelivery carries a fresh timestamp, so key your own processing on the job id, not on the timestamp, and make the handler safe to run twice.

• Verify the sume-v1 signature before you trust the body.
• Deduplicate on job id so a redelivery does not write a transcript twice.
• Return a 2xx quickly and do heavy work after you respond.

How do you call it?

Pass the job id from the original submit response:

import os, requests

H = {"Authorization": "Bearer " + os.environ["SUME_API_KEY"]}
job_id = os.environ["JOB_ID"]

r = requests.post(
    f"https://api.sume.com/v1/jobs/{job_id}/webhook/redeliver",
    headers=H, timeout=30,
)
print(r.status_code)
if r.status_code == 409:
    print("job still running or no webhook_url was set")

When is polling better?

If you cannot expose a public HTTPS endpoint at all, skip webhooks and poll /v1/jobs/{id}/status. The webhook URL must be public HTTPS; localhost, private-network and non-HTTPS URLs are rejected. For the wider pattern of job ids and hosted artifacts, see keeping a TTS pipeline portable.