Edit

agentInterface resource type

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Important

Upcoming change to Agent Registry APIs

Starting May 2026, the Agent Registry APIs in Microsoft Graph will be replaced by newer Agent Registry APIs powered by Microsoft Agent 365. This change consolidates agent management experiences to make it easier to observe, govern, and secure all agents in your tenant. We recommend that you plan to migrate to the new Agent 365-based APIs when they are released. Learn more about Agent Registry convergence with Microsoft Agent 365.

Declares a combination of a target URL and a transport protocol for interacting with the agent, as defined in the agentInstance object. This allows agents to expose the same functionality over multiple transport mechanisms.

Properties

Property Type Description
transport String The transport protocol supported at this URL.
url String The URL where this interface is available. Must be a valid absolute HTTPS URL in production.

Relationships

None.

JSON representation

The following JSON representation shows the resource type.

{
  "@odata.type": "#microsoft.graph.agentInterface",
  "url": "String",
  "transport": "String"
}