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_apichat | responsesProtocol 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.
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗