Skip to content
CC Switch WikiUnofficial Community Wiki

Invalid type for 'messages': expected an array - Codex

Quick fix

Upgrade cc-switch to the latest version for the conversion fix, or downgrade the Codex CLI to 0.80.0 and use wire_api="chat" to work around it.

Symptom

Section titled “Symptom”
Error output
Invalid type for 'messages': expected an array of objects, but got null instead.

Cause

Section titled “Cause”

From Codex CLI 0.99 on, the wire_api = "chat" option was removed officially, forcing the Responses API. When cc-switch tries to forward a Codex Responses API request (carrying an input field) to an upstream that only supports Chat Completions — MiniMax or JD Cloud, for example — a defect in the conversion logic fails to map input into a messages array, leaving messages null. The upstream API validation fails and returns HTTP 400.

Fix

Section titled “Fix”

  1. Upgrade cc-switch to the latest version, where the Responses API to Chat Completions conversion logic is fixed.

  2. If you cannot upgrade cc-switch yet, downgrade the Codex CLI to 0.80.0 (the last version supporting chat mode) and edit the Codex config file:

    ~/.codex/config.toml
    wire_api = "chat"

Affected Versions

Section titled “Affected Versions”
ToolCodex
Version>= 0.99.0
PlatformsWindowsmacOS

Source Issues

Section titled “Source Issues”

This page is distilled from 4 real issues

FAQ

Section titled “FAQ”
Why does requesting the upstream API directly with curl not error?
The upstream API itself is healthy. The error happens because cc-switch, as the middleware, fails to build the messages array during protocol conversion, so what upstream actually receives is null.
Section titled “Related problems”
temporarily unavailable, so auto mode cannotUpgrade cc-switch to v3.15.0+ for the model mapping and thinking conversion fixes, or override the default model env var in general config.5 issues mergedsettings.json Full Overwrite Causes Plugin FailureUpgrade to v3.20.1+ to fix the bug that clears enabledPlugins when switching configs.9 issues mergedError running remote compact taskTurn Remote Compaction off in Codex settings and use local compaction, working around this protocol conversion defect.4 issues merged

This is an unofficial community wiki with no affiliation to the cc-switch authors or the project itself. Its content is compiled from the project's public GitHub issues. This site distributes no software.