Erro ao carregar os seus agentes.api-version=v1 is not allowed. Use /v1 path instead. ID da Solicitação: xxxxxxxxxxx

Hello Josue Moraes,

Welcome to Microsoft Q&A.

Thanks for sharing the screenshot, this error is related to a recent API versioning change in Azure AI Foundry (Agents/Assistants) and is not caused by your configuration.

What’s happening

The error api-version=v1 is not allowed. Use /v1 path instead means that Azure has moved from query-based versioning to path-based versioning.

So instead of using:

...?api-version=v1

You now need to use:

/v1/...

Why you’re seeing this in the Foundry portal

Since this error appears directly in the Foundry UI (Agents page), it indicates that:

The portal is making backend API calls using the old format (api-version=v1), which is now rejected.

This can happen due to:

• A recent API transition rollout
• A temporary mismatch between the UI and backend services
• Cached/stale requests in the browser

Here are the few steps you can do

1. Refresh the browser

• Perform a hard refresh: Ctrl + Shift + R
• Or try opening in an incognito/private window

2. Verify which API you are using

If using the older Assistants (Preview) API

You should switch to a supported preview version, for example:

GET https://<your-resource>.openai.azure.com/openai/assistants?api-version=2025-04-01-preview

If using the new Agents service (GA)

Use the new /v1 path-based endpoint, and do NOT pass api-version:

GET https://<your-resource>.openai.azure.com/openai/agents/v1

3. Check permissions

Ensure your identity has:

• Contributor or higher on the resource
• Or appropriate access to the Azure AI Foundry Agent Service

Clarification

• This is not an issue with your agents, RBAC, or deployment
• It’s related to API versioning changes + portal behavior
• Your configuration is likely correct

Please refer this

• Resolve 404 Errors in Azure OpenAI Assistants API https://learn.microsoft.com/azure/ai-foundry/quickstarts/get-started-code?tabs=azure-ai-foundry&pivots=fdp-project
• Resolving API Version Issues with Azure OpenAI https://learn.microsoft.com/azure/ai-services/openai/api-version-lifecycle?#latest-ga-api-release
• Azure OpenAI in Microsoft Foundry Models REST API preview reference https://learn.microsoft.com/azure/foundry/openai/reference-preview?wt.mc_id=knowledgesearch_inproduct_azure-cxp-community-insider
• Microsoft Foundry Project REST reference (Agents) https://learn.microsoft.com/azure/foundry/reference/foundry-project-rest-preview?wt.mc_id=knowledgesearch_inproduct_azure-cxp-community-insider#agents---list-agent-versions

I Hope this helps. Do let me know if you have any further queries.

Thank you!