Webhooks

YT2Text can send outbound POST callbacks for public video jobs.

Supported Events

• job.completed

• job.failed

Only these two event types are emitted by the current backend.

Delivery Rules

• production requires an HTTPS destination
• localhost HTTP is only allowed in development
• SSRF protections block loopback, private, link-local, reserved, and multicast destinations
• non-2xx responses are treated as failed deliveries

Payload Shape

Completed job example:

{
  "event": "job.completed",
  "timestamp": "2026-03-22T12:00:00Z",
  "data": {
    "job_id": "uuid",
    "status": "completed",
    "video_id": "dQw4w9WgXcQ",
    "video_info": {
      "title": "Example title"
    },
    "summaries": {
      "tldr": {
        "content": "Summary text"
      }
    },
    "processing_time": 8.2,
    "content_url": "https://..."
  }
}

Failed job example:

{
  "event": "job.failed",
  "timestamp": "2026-03-22T12:00:00Z",
  "data": {
    "job_id": "uuid",
    "status": "failed",
    "video_id": "dQw4w9WgXcQ",
    "error": "Processing failure message"
  }
}

Signatures

The webhook transport helper supports optional HMAC signing internally, but the current public API does not expose webhook-secret configuration. Public integrations should not rely on

X-Webhook-Signature