Driftwatch

OpenAI / OpenAI API /

Breakingdirection flip: their tools call this safe

Response field finish_reason 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 choices[].finish_reason on CreateChatCompletionStreamResponse reachable from 1 operation. Nothing fails at the call; it fails wherever the value is finally used, which is usually somewhere else entirely.

no longer guaranteed present

Who is affected

Code that reads OpenAI's CreateChatCompletionStreamResponse objects, used by 1 OpenAI operation.

Before and after

WhereBeforeAfter
CreateChatCompletionStreamResponse.choices[].finish_reasonalways presentmay be missing

Code that breaks

// response.choices[0].finish_reason may now be absent or null
const finish_reason = response.choices[0].finish_reason ?? fallback;

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