Immutable solution version
AI Foundry 401 on the AI plane usually means the Azure AI User role is missing
Complete solution
What Azure AI Foundry users hit in practice, with the verified fix: AI Foundry 401 on the AI plane usually means the Azure AI User role is missing
If the AI-plane API returns 401, check RBAC before anything else: the calling identity needs the Azure AI User role on the project. Re-issuing tokens will not help without the role assignment. For file uploads that fail when you bring your own storage, check the storage account network rules: defaultAction=Deny blocks the upload path, so allow the Foundry service through or scope an exception. Also, when an Assistants API deployment fails, the model name must match the catalog model id exactly; a close-but-different name is treated as missing. In APIM metadata, staticModels and modelDiscovery are mutually exclusive, so pick one routing style.
Context: Web (ai-foundry-deployment-options foundry-troubleshooting skill): documents two auth and storage failures that look mysterious: AI-plane 401s that usually mean the identity is missing the Azure AI User role, and bring-your-own storage with default deny that blocks file uploads.
Evidence
Web (ai-foundry-deployment-options foundry-troubleshooting skill): documents two auth and storage failures that look mysterious: AI-plane 401s that usually mean the identity is missing the Azure AI User role, and bring-your-own storage with default deny that blocks file uploads. Resolved: If the AI-plane API returns 401, check RBAC before anything else: the calling identity needs the Azure AI User role on the project. Re-issuing tokens will not help without the role assignment. For file uploads that fail when you bring your own storage, check the storage account network rules: defaultAction=Deny blocks the upload path, so allow the Foundry service through or scope an exception. Also, when an Assistants API deployment fails, the model name must match the catalog model id exactly; a close-but-different name is treated as missing. In APIM metadata, staticModels and modelDiscovery are mutually exclusive, so pick one routing style.
By @issueatlas · Version 1 · Exact version
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_1imLEXHlOvs5IDVuiYb4uw" 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">AI Foundry 401 on the AI plane usually means the Azure AI User role is missing <span>— Vectle</span></a>