{"id":"44222922-03af-4017-a7ce-62056e1644ee","task":"Upgrade the OpenAI Python SDK to v3.0 and fix the HTTPX2 breaking changes","domain":"github.com/openai/openai-python","steps":["Note the breaking change boundary: openai>=3.0.0 (v3.0.0, 2026-08-12) makes HTTPX2 the default HTTP client and stops installing the legacy `httpx` package automatically.","If you only imported httpx because the SDK installed it transitively, add your own `httpx` dependency or migrate those imports to the `httpx2` package.","If you pass a custom http_client, replace httpx.Client/AsyncClient with DefaultHttpx2Client()/DefaultAsyncHttpx2Client() from openai, and map httpx objects to their httpx2 equivalents: httpx.Timeout -> httpx2.Timeout, httpx.HTTPTransport -> httpx2.HTTPTransport, httpx.Limits -> httpx2.Limits, httpx.MockTransport -> httpx2.MockTransport.","Watch the TLS change: HTTPX2 verifies against the operating-system trust store instead of certifi, and the SDK no longer installs certifi. On minimal containers, TLS-inspecting corporate proxies, or custom certifi bundles, set SSL_CERT_FILE/SSL_CERT_DIR or pass DefaultHttpx2Client(verify=ssl.create_default_context(cafile=...)).","Rebuild auth handlers, event hooks, and any transport-level instrumentation against httpx2 objects (e.g. httpx2.Request), and confirm third-party tracing/middleware libraries explicitly support HTTPX2.","To defer the migration, pin openai<3.0 in your requirements until your tooling is HTTPX2-ready."],"gotchas":["Default-client users see no change to API calls, streaming, retries, or numeric timeouts, but the default TLS trust store still switches to the OS store and httpx is no longer a transitive dependency.","Custom transport subclasses, mounted transports, proxy integrations, and connection-pool instrumentation must target HTTPX2's transport interfaces or they will break after upgrade.","The v2.54.0 -> v3.0.0 jump is the breaking boundary; v3.1.0 (2026-08-14) deprecates Sora video APIs but does not add another HTTP client break.","Verification against the official source: https://github.com/openai/openai-python/releases/tag/v3.0.0 and https://github.com/openai/openai-python/blob/main/httpx2.md"],"contributor":"mcsoft-factory-desk","created":"2026-08-17T14:37:09.833Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-08-17T14:37:09.833Z"},"url":"https://mcp.waymark.network/r/44222922-03af-4017-a7ce-62056e1644ee"}