Missing `name` field in Realtime function-call event in OpenAPI spec breaks generated SDK models

Inizia con lo schema OpenAPI e la documentazione per l’evento Realtime response.function_call_arguments.done, usando come contesto il riferimento Realtime API collegato. Conferma che l’evento includa name come stringa, quindi rigenera i modelli Java SDK interessati e verifica che il modello generato rappresenti il payload del server.

Summary

The Realtime API returns a name field in the response.function_call_arguments.done event payload, but this field is not documented and not present in the OpenAPI spec. Because the Java SDK is generated from the spec, the resulting model does not include the field, causing incomplete deserialization and forcing manual workarounds.

This is a Bug + Spec fix + Enhancement issue.

---

Impacted Endpoint / Event

response.function_call_arguments.done (Realtime API)

Docs reference:
https://platform.openai.com/docs/api-reference/realtime-server-events/response/function_call_arguments/done

---

Current Docs & Spec Behavior

Docs example (no name field):

{
  "event_id": "event_5556",
  "type": "response.function_call_arguments.done",
  "response_id": "resp_002",
  "item_id": "fc_001",
  "output_index": 0,
  "call_id": "call_001",
  "arguments": "{\"location\": \"San Francisco\"}"
}

---

Actual Server Behavior

Actual Realtime events include a name field, for example:

{
  "type": "response.function_call_arguments.done",
  "name": "getWeather",
  ...
}

---

Expectation

The OpenAPI spec and documentation should include the name field so that SDK models (including Java) correctly represent function-calling data.

---

Impact / Severity

Severity: B — Major (workaround possible but painful)

Consequences:

• Generated models are incomplete

• Function name context is lost

• Cannot rely on strongly-typed SDK

• Cannot round-trip Realtime function-calling data via SDK

---

Workaround

Currently working around this by parsing raw JSON event payloads.

---

Root Cause

Spec / docs mismatch → incorrect OpenAPI → incorrect SDK generation.

---

Proposed Fix

• Add name: string to the response.function_call_arguments.* events in the OpenAPI specification and documentation

• Regenerate affected SDKs (Java + others)

---

Environment

Component | Value -- | -- SDK | openai-java v4.16.1 Java | 21 OS | Windows 11

---

Type of Issue

• Bug

• Spec / Documentation

• Enhancement (generated SDK)

---

Why Combined

Fixing the spec resolves the SDK issue automatically without needing separate work.

---

Closing Note

This issue makes Realtime function-calling harder to use via strongly-typed models. Aligning the spec/docs with server behavior would resolve the bug and improve developer ergonomics across generator-based SDKs.

Thanks! 🙏