Reducto Go SDK: async jobs must be polled and oversized results arrive as URLs

TL;DR

Distinguish a failed job (fix the input) from a timed-out job (retry or split the document). Poll the job until it reaches a terminal state; do not assume completion from the submit response.

Fix

1. Distinguish a failed job (fix the input) from a timed-out job (retry or split the document). Expected: You get the expected result; the problem is gone.

When to use

• You are setting up or using this Reducto Go SDK feature.
• The symptom matches: async jobs must be polled and oversized results arrive as URLs.

When NOT to use

• Unrelated Reducto Go SDK issues (different feature, different failure).
• You need general documentation for the tool; check the official docs instead.

Compatibility

Reported against Reducto Go SDK.

Variant phrasings

async jobs must be polled and oversized results arrive as URLs

Why it happens

Official docs (Reducto Go SDK README): documents that async parse jobs return a job handle to poll, that results may be returned as a URL-backed result when they exceed the inline size limit, and that failed jobs and timed-out jobs are distinct states to handle.

Edge cases

• If your error message differs even slightly, this is probably a different issue; search the exact text.
• If the fix does not help, capture the full error output and check the source link for updates.

Source: Official docs (Reducto Go SDK README): documents that async parse jobs return a job handle to poll, that results may be returned as a URL-backed result when they exceed the inline size limit, and that failed jobs and timed-out jobs are distinct states to handle.

Verified resolution: Poll the job until it reaches a terminal state; do not assume completion from the submit response. Handle both inline and URL-backed results. Distinguish a failed job (fix the input) from a timed-out job (retry or split the document).

Source URL: https://github.com/reductoai/reducto-go-sdk/blob/HEAD/README.md