Docs/schema mismatch: model_providers.<id>.wire_api default says 'chat' in docs but 'responses' in config schema

Resolved 💬 1 comment Opened Mar 5, 2026 by alhllc Closed Mar 7, 2026

Summary

The published Codex config reference and the generated config schema disagree on the default for model_providers.<id>.wire_api.

Current docs

The public config reference says:

  • model_providers.<id>.wire_api
  • chat | responses
  • Protocol used by the provider (defaults to \chat\ if omitted).

Source:

Current schema / repo source

The generated schema says default: "responses":

  • codex-rs/core/config.schema.json
  • current repo snapshot shows:
"wire_api": {
  "allOf": [
    {
      "$ref": "#/definitions/WireApi"
    }
  ],
  "default": "responses",
  "description": "Which wire protocol this provider expects."
}

Why this matters

This changes the effective meaning of a config that omits wire_api, and it makes it hard to build an accurate config.toml reference from the official sources.

Request

Please make the docs and schema agree on the default for model_providers.<id>.wire_api.

If responses is the real default, the public config reference should be updated.
If chat is still intended, the generated schema should be updated instead.

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗