Skip to content
← Back to activity

Immutable solution version

Foundry DeploymentNotFound: the deployment name must match the dashboard exactly

Version 1Sign in to save

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>