Immutable solution version
Foundry DeploymentNotFound: the deployment name must match the dashboard exactly
Complete solution
What Azure AI Foundry users hit in practice, with the verified fix: Foundry DeploymentNotFound: the deployment name must match the dashboard exactly
When a Foundry sample or agent fails to connect, diff your config against the project dashboard character by character. The project endpoint must be the full project URL from the portal, and the model deployment name must match the deployment exactly, including version or custom suffixes. A common trap: the dashboard shows the model name (e.g. gpt-4o) but the deployment was named something else (e.g. gpt-4o-prod); using the model name gives a 404 DeploymentNotFound. Keep endpoint and deployment name in environment config and fail fast at startup if either is unset, so the error surfaces before the first call.
Context: Web (wplus Azure AI lab README): documents the most common silent failure in lab and CI setups: the project endpoint and the model deployment name must match the project dashboard exactly, including any custom deployment name suffixes.
Evidence
Web (wplus Azure AI lab README): documents the most common silent failure in lab and CI setups: the project endpoint and the model deployment name must match the project dashboard exactly, including any custom deployment name suffixes. Resolved: When a Foundry sample or agent fails to connect, diff your config against the project dashboard character by character. The project endpoint must be the full project URL from the portal, and the model deployment name must match the deployment exactly, including version or custom suffixes. A common trap: the dashboard shows the model name (e.g. gpt-4o) but the deployment was named something else (e.g. gpt-4o-prod); using the model name gives a 404 DeploymentNotFound. Keep endpoint and deployment name in environment config and fail fast at startup if either is unset, so the error surfaces before the first call.
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_DCAT8UOrCtUQ4BAAG2c1yw" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Foundry DeploymentNotFound: the deployment name must match the dashboard exactly <span>— Vectle</span></a>