Skip to content
AI Agent Access Control

Azure OpenAI Assistants has no identity of its own: callers use a key or an Entra role on the resource, and the API is retired

Azure OpenAI Assistants (Preview) is documented by Microsoft as retired in favor of Foundry Agent Service. The quickstart authenticates with an API key; Entra ID with the Cognitive Services OpenAI User role is the documented alternative. The assistant itself holds no cloud role, so its reach is its tools. Read 16 Nov 2026.

See the ranking ยท All guides

Status first: the Assistants API is retired

Microsoft's page on getting started with Azure OpenAI Assistants (Preview) carries the note that the Assistants API is retired, that the generally available Microsoft Foundry Agents service replaces it, and that a migration guide exists (Microsoft: getting started with Azure OpenAI Assistants (classic), read 16 Nov 2026). The page applies only to the Foundry (classic) portal. Accounts that still run assistants should treat the access below as something to move or remove. The replacement is on the Foundry Agent Service page.

The identity: the caller's, because the assistant has none

In the documented quickstart the application creates the client with an API key read from an environment variable. An assistant object is created through the API with instructions, a model deployment and tools. Nothing in the pages read describes a managed identity or service principal assigned to the assistant. Microsoft documents that the Azure OpenAI resource can instead be called with Microsoft Entra ID: your code requests a short-lived token for an identity that holds a role on the resource, which can be your developer account, a system-assigned or user-assigned managed identity, or a service principal (Microsoft: Entra ID authentication for Azure OpenAI). An assistant-specific role: none found on 16 Nov 2026.

What the defaults let a caller do

CredentialWhat it allows on the resourceDocumented limit
Resource API keyCalls to the resource's endpoints, including the Assistants API; the quickstart authenticates this wayMicrosoft lists viewing and copying keys as a permission separate from the OpenAI User and Contributor roles
Cognitive Services OpenAI User roleChat, completions and inference API calls with Entra ID; view deploymentsCannot create resources or deployments, copy keys, or create customized guardrails
Cognitive Services OpenAI Contributor roleEverything in the User role, plus fine-tuning, stored completions and creating or editing deploymentsCannot create resources, view keys or access quota
Cognitive Services Contributor roleCreate resources in the resource group; view and regenerate keysTypically granted at the resource group with other roles

What the assistant's tools reach

Microsoft documents that an individual assistant can access up to 128 tools, including code interpreter and file search, and custom functions. Code interpreter gives the model a sandboxed Python environment. Custom functions are tools you define, so what they reach depends on the code and the identity behind them. The cloud reach of an assistant is therefore the files you attach plus whatever those functions' identity can reach. See the identity guide for that second identity.

How to narrow it

  • Call the resource with Microsoft Entra ID and a role of Cognitive Services OpenAI User, assigned at the resource scope rather than the subscription (check: narrowest scope).
  • Microsoft notes that subscription-level Owner and Contributor roles are inherited and take priority over the custom Azure OpenAI roles applied at the resource group, so check for them first.
  • Give each application its own managed identity so calls can be traced (check: attribute actions to the agent).
  • Give any function host its own role limited to what that function does (check: a role per tool).
  • Plan the migration to Foundry Agent Service, where a new agent identity starts with no roles, as the Azure agent permissions guide describes.

Sources

  1. Microsoft: getting started with Azure OpenAI Assistants (classic), read 16 Nov 2026
  2. Microsoft: Azure RBAC for Azure OpenAI (classic), read 16 Nov 2026
  3. Microsoft: Microsoft Entra ID authentication for Azure OpenAI (classic), read 16 Nov 2026
  4. Microsoft: agent identity concepts in Foundry, read 16 Nov 2026

Last reviewed 16 Nov 2026.