Repository navigation
What's Changed
Features
- Expose the verdict the API declares on an error as typed attributes on every HTTP error:
retryable,error_type,error_reasonandaudience. Errors the API raises deliberately publish these fields next todetail, eg a 503 OCR timeout with"retryable": false. Callers no longer need to parseerr.bodyto read them. Each attribute isNonewhen the body is not JSON, the field is absent, or its value has the wrong type. The retry loop readsretryablewith the same parser. - Add
skip_preflighttoCreateWorkflowandUpdateWorkflow. Set it toTrueto skip the job preflight check for a workflow's jobs; on update, leaving it unset keeps the current value.WorkflowInformation.skip_preflightreports the workflow's current setting. For a one-off job, set"skip_preflight": truein therequest_dataJSON passed tojobs.create_job.
Fixes
- Deserialize jobs the preflight check rejected.
JobStatusandJobProcessingStatusgainREJECTED; previouslyjobs.get_jobraised on a rejected job, and one rejected job failed the wholejobs.list_jobspage.JobInformation.statusandJobDetails.processing_statusnow also accept a status this SDK version does not know, returning it as a plainstrinstead of raising. Known statuses are still returned as enum members, but the fields are typedUnion[JobStatus, str]andUnion[JobProcessingStatus, str], so type-checked code that reads.valueor.namefrom them needs to handle thestrcase. - Expose why a job was rejected.
JobNodeDetailsgainsfailure_category(aPreflightFailureCategory, or a plainstrfor a category this SDK version does not know) andfailure_reason, set on the node that failed preflight injobs.get_job_details. Previously both were dropped during deserialization. - Bump locked
certifito 2026.10.19, which removes the emSign ECC Root CA - G3 root after eight eMudhra intermediate CA private keys were compromised.requestsandhttpxtrust certifi's bundle and do not check revocation, so with the older bundle they accepted certificates chaining to that root.certifiis now also a direct dependency at>=2026.10.19, so pip installs pick up the new bundle too. - Long partitions behind a NAT or load balancer idle timeout could never return, leaving the client waiting for its full read timeout. SDK-owned HTTP clients now enable TCP keepalive, including split-PDF requests. Connections made through an HTTP(S)/SOCKS proxy are not covered. Configure probes with
UNSTRUCTURED_CLIENT_TCP_KEEPALIVE_IDLE(60 seconds),UNSTRUCTURED_CLIENT_TCP_KEEPALIVE_INTERVAL(30 seconds), andUNSTRUCTURED_CLIENT_TCP_KEEPALIVE_COUNT(5); setUNSTRUCTURED_CLIENT_TCP_KEEPALIVE=0orfalseto disable. Caller-supplied clients are unchanged.
Full Changelog: v0.46.4...v0.47.0