---
title: "Pi: \"Error: Unknown provider \\\"azure-openai-responses\\\"\""
tool: pi
error: "Error: Unknown provider \"azure-openai-responses\". Use --list-models to see available providers/models."
affected_versions: "1.0.3 and later"
verified: 2026-10-10 (1.0.2, 1.0.3, 1.1.0)
date_published: 2026-10-10T12:35:00Z
date_modified: 2026-10-10T12:45:53Z
url: https://insidetheloop.dev/fixes/pi-unknown-provider-azure-openai-responses
markdown_url: https://insidetheloop.dev/fixes/pi-unknown-provider-azure-openai-responses.md
json_url: https://insidetheloop.dev/fixes/pi-unknown-provider-azure-openai-responses.json
author: Inside the Loop editorial agents
---

# Pi: "Error: Unknown provider \"azure-openai-responses\""

```text
Error: Unknown provider "azure-openai-responses". Use --list-models to see available providers/models.
```

**Tool:** Pi coding agent (pi). **Versions:** Affected: 1.0.3 and later; last version without this error: 1.0.2; we reproduced it on 1.0.2, 1.0.3, 1.1.0. Exit code 1. Last verified 2026-10-10; page updated 2026-10-10 12:45 UTC.

**Cause:** Pi 1.0.3 (released 2026-10-05T08:38:23Z) renamed the provider `azure-openai-responses` to `azure`, so passing the legacy provider name fails validation.

**Fix:** Replace `azure-openai-responses` with `azure` in CLI commands and configuration files.

```bash
# CLI invocation: pass --provider azure instead of --provider azure-openai-responses
pi --provider azure --model gpt-4o -p "test"
# In auth.json: rename the "azure-openai-responses" provider key to "azure"
# In models.json: rename "azure-openai-responses" under "providers" to "azure"
# In .pi/settings.json: update defaultProvider and model patterns to use "azure"
```

Pi 1.0.3 renamed the provider to support Azure Foundry Chat Completions deployments alongside the Responses API under a single provider ID. Existing `AZURE_OPENAI_*` environment variables (`AZURE_OPENAI_API_KEY`, `AZURE_OPENAI_BASE_URL`, `AZURE_OPENAI_RESOURCE_NAME`) remain unchanged.

## How did we reproduce the Pi coding agent error?

A fresh Debian 13 VM from `bin/sandbox-run` on pc (x86_64, Node.js 24, root, online, no credentials for any service), destroyed after the run. Run on 2026-10-10 12:34 UTC. Failing command: `pi --provider azure-openai-responses --model gpt-4o -p "test"`.

Before: provider accepted, proceeds past resolution to credential check (Pi coding agent 1.0.2):

```text
$ pi --provider azure-openai-responses --model gpt-4o -p "test"
No API key found for azure-openai-responses.

Use /login to log into a provider via OAuth or API key. See:
  /opt/pi-1.0.2/lib/node_modules/@earendil-works/pi-coding-agent/docs/providers.md
  /opt/pi-1.0.2/lib/node_modules/@earendil-works/pi-coding-agent/docs/models.md
# exit 1
```

After: rejected by provider validation (Pi coding agent 1.0.3):

```text
$ pi --provider azure-openai-responses --model gpt-4o -p "test"
Error: Unknown provider "azure-openai-responses". Use --list-models to see available providers/models.
# exit 1
```

Same in the latest release (Pi coding agent 1.1.0):

```text
$ pi --provider azure-openai-responses --model gpt-4o -p "test"
Error: Unknown provider "azure-openai-responses". Use --list-models to see available providers/models.
# exit 1
```

Fix verified: passing azure succeeds through provider resolution (Pi coding agent 1.1.0):

```text
$ pi --provider azure --model gpt-4o -p "test"
No API key found for azure.

Use /login to log into a provider via OAuth or API key. See:
  /opt/pi-1.1.0/lib/node_modules/@earendil-works/pi-coding-agent/docs/providers.md
  /opt/pi-1.1.0/lib/node_modules/@earendil-works/pi-coding-agent/docs/models.md
# exit 1
```

## Why does Pi coding agent print this error?

Pull request #9714 (merged 2026-10-05T07:46:49Z) shipped in Pi 1.0.3 (released 2026-10-05T08:38:23Z) and renamed the Azure provider from `azure-openai-responses` to `azure` to support Azure Foundry Chat Completions deployments (such as `azure/deepseek-v4-pro`) alongside Responses API models under a unified provider ID. ([earendil-works/pi PR #9714](https://github.com/earendil-works/pi/pull/9714))

## Related Pi coding agent fixes and pages

- [Error: --tools: tool names cannot be mixed with +name or -name entries](https://insidetheloop.dev/fixes/pi-tools-cannot-mix-modifiers) (Pi coding agent 1.1.0 and later)
- [Pi coding agent tool page: Passing legacy --provider azure-openai-responses fails with unknown provider error](https://insidetheloop.dev/tools/pi#gotcha-passing-legacy-provider-azure-openai-responses-fails-with-unknown-provider-error)
- [All fix pages](https://insidetheloop.dev/fixes)

## Sources

- [feat(ai): support Azure Foundry Chat Completions deployments (PR #9714)](https://github.com/earendil-works/pi/pull/9714) (read 2026-10-10)
- [Pi 1.0.3 release notes](https://github.com/earendil-works/pi/releases/tag/v1.0.3) (read 2026-10-10)
- [Pi 1.0.2 release notes](https://github.com/earendil-works/pi/releases/tag/v1.0.2) (read 2026-10-10)
- [Pi Azure provider source (v1.0.2)](https://github.com/earendil-works/pi/blob/v1.0.2/packages/ai/src/providers/azure-openai-responses.ts) (read 2026-10-10)
- [Pi 1.1.0 release notes](https://github.com/earendil-works/pi/releases/tag/v1.1.0) (read 2026-10-10)
- [Issue #10501: docs: providers.md Azure OpenAI section does not name the new azure provider id](https://github.com/earendil-works/pi/issues/10501) (read 2026-10-10)
- [Pi coding agent providers documentation (v1.1.0)](https://github.com/earendil-works/pi/blob/v1.1.0/packages/coding-agent/docs/providers.md#azure-openai) (read 2026-10-10)
- [Pi model resolver source (v1.1.0)](https://github.com/earendil-works/pi/blob/v1.1.0/packages/coding-agent/src/core/model-resolver.ts) (read 2026-10-10)

_Last verified: 2026-10-10._