Driftwatch

OpenAI / OpenAI API /

Breakingdirection flip: their tools call this safe

Response field url is no longer guaranteed

What changed

Producer-side tools call this non-breaking. For a consumer it is a null dereference on an unknown future date.

Affects url on BetaWebSearchActionFind reachable from 6 operations. Nothing fails at the call; it fails wherever the value is finally used, which is usually somewhere else entirely.

no longer guaranteed present; can now be null

Who is affected

Code that reads OpenAI's BetaWebSearchActionFind objects, used by 10 OpenAI operations.

Before and after

WhereBeforeAfter
BetaWebSearchActionFind.urlalways presentmay be missingno longer guaranteed present
BetaWebSearchActionFind.urlstringnull|stringcan now be null
WebSearchActionFind.urlalways presentmay be missingno longer guaranteed present
WebSearchActionFind.urlstringnull|stringcan now be null

Code that breaks

// response.url may now be absent or null
const url = response.url ?? fallback;

Based on OpenAI’s published API specification. How severity is decided.