Codex CLI 0.147.0 Sends Empty Tool Description to Azure Responses API
Open 💬 15 comments Opened Aug 7, 2026 by AdityaVishwakarmaIN
💡 Likely answer: A maintainer (github-actions[bot], contributor)
responded on this thread — see the highlighted reply below.
What version of Codex CLI is running?
0.147.0
What subscription do you have?
Pro
Which model were you using?
_No response_
What platform is your computer?
_No response_
What terminal emulator and version are you using (if applicable)?
_No response_
Codex doctor report
What issue are you seeing?
After upgrading Codex CLI to 0.147.0, every prompt fails before inference when using Azure OpenAI Responses API:
Invalid 'input[0].tools[0].description': empty string.
Expected a string with minimum length 1, but got an empty string instead.
Downgrading to 0.146.1 resolves the issue.
What steps can reproduce the bug?
Uploaded thread: 019fdd80-f401-7aa3-b4b4-137253e78e05
What is the expected behavior?
_No response_
Additional information
_No response_
15 Comments
Potential duplicates detected. Please review them and close your issue if it is a duplicate.
Powered by Codex Action
Duplicate of #37425
downgrade 0.146.1 and working fine
npm install -g @openai/codex@0.146.1Same issue, what's the solution?:
facing the same issue here
+1 Same issue, reproducible on 0.147 by sending any message
I just checked codex v0.148.0-alpha.9 : the problem still exists there. For now, use
npm install -g @openai/codex@0.146.1I had faced same issue and the older version did help.
However, according to the error message which can be address to the parameter in models.json. The parameter is called "use_responses_lite". The default value is true, and all you have to change is to false.
This works, now I successfully update openai codex to the newer version(>=0.147). Hope this would help!
can confirm that turning off "use_responses_lite" works on 0.147
@oferlaor Thanks. To spell out what I did:
~/.codex/.~/.local/share/codexby using theCODEX_HOMEenvironment variable. Your choice.codexsource coderust-v0.147.0)models.jsonto your local Codex directorymodels.jsonuse_responses_litefromtruetofalsefor the various gpt-5.6 models you useconfig.tomlmodel_catalog_jsonto point to your local copy ofmodels.json```toml
model = "gpt-5.6-sol"
model_provider = "azure"
model_catalog_json = "~/.codex/models.json"
[model_providers.azure]
name = "azure"
base_url = "https://<resource>.cognitiveservices.azure.com/openai/v1"
wire_api = "responses"
env_key = "AZURE_OPENAI_KEY"
```
One big request: Please sit down with a pen and paper for _at least_ 15 minutes and consider each of the following claims to the best of your ability:
P.S. I took the time to write up these detail, so please forgive me if you disagree with my points at the end. It is irresponsible for people to just "shut up and do their work" now. Just like it was unethical for physicists to work on the Manhattan Project when their ethics said it was wrong.
+1,When will this be fixed? v26.810.41047 cannot
After downgrading my Windows plugin to 26.803.61601, it works. The CLI version should be v0.147.0-alpha.6.5
<img width="877" height="159" alt="Image" src="https://github.com/user-attachments/assets/7286c60c-b320-4c60-81da-8b283e56cabe" />
@wssf812 This is just a tooling comment, apologies if it is not helpful or I'm missing something... If that screenshot reflects what you see, perhaps your terminal emulator is causing your glyphs to not line up. It doesn't have to look that bad... :) Have you considered using a modern terminal emulator like Ghostty (my favorite) or Alacritty (also good)?
Same root cause as #37952 (also #37692, #37675):
default_namespace_descriptiondeliberately returns an empty string for the defaultfunctionsnamespace (https://github.com/openai/codex/blob/1f41cc5d92/codex-rs/tools/src/responses_api.rs#L64-L70); OpenAI's backend tolerates it, Azure's validator rejects both the empty string and the field's absence. One-line fix discussed in #37952 — this looks like a duplicate.0.148 still has this issue.
same here