AgentCollection.Read.All

Allows the app to read collections and their membership in your organization's Agent Registry on behalf of the signed-in user.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the AgentCollection.Read.All permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	e65ee1da-d1d5-467b-bdd0-3e9bb94e6e0c	fa50be38-fdff-469c-96dc-ef5fce3c64bf
DisplayText	Read all collections in Agent Registry	Read collections in Agent Registry
Description	Allows the app to read all collections and their membership in your organization's Agent Registry without a signed-in user.	Allows the app to read collections and their membership in your organization's Agent Registry on behalf of the signed-in user.
AdminConsentRequired	Yes	Yes

Graph Methods

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	GET /agentRegistry/agentCollections
	GET /agentRegistry/agentCollections/{agentCollectionId}
	GET /agentRegistry/agentInstances/{agentInstanceId}/collections/{agentCollectionId}/members

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

agentCollection
agentInstance

Graph reference: agentCollection

Property	Type	Description
createdBy	String	Object ID of the user or app that created the agent instance.
createdDateTime	DateTimeOffset	Timestamp when agent collection was created.
description	String	Description / purpose of the collection.
displayName	String	Friendly name of the collection.
id	String	Unique identifier for the collection. Key. Inherited from entity.
lastModifiedDateTime	DateTimeOffset	Timestamp of last update.
managedBy	String	appId (referred to as Application (client) ID on the Microsoft Entra admin center) of the service principal managing this agent.
originatingStore	String	Source system/store where the collection originated. For example `Copilot Studio`.
ownerIds	String collection	List of object IDs for the owners of the agent instance.

Graph reference: agentInstance

Property	Type	Description
additionalInterfaces	agentInterface collection	Additional interfaces/transports supported by the agent.
agentIdentityBlueprintId	String	Object ID of the agentIdentityBlueprint object.
agentIdentityId	String	Object ID of the agentIdentity object.
agentUserId	String	Object ID of the agentUser associated with the agent. Read-only.
createdBy	String	Object ID of the user or application that created the agent instance. Read-only.
createdDateTime	DateTimeOffset	Timestamp when agent instance was created. Read-only.
displayName	String	Display name for the agent instance.
id	String	Unique identifier for the agent instance. Key. Inherited from entity.
lastModifiedDateTime	DateTimeOffset	Timestamp of last modification.
managedBy	String	appId (referred to as Application (client) ID on the Microsoft Entra admin center) of the application managing this agent.
originatingStore	String	Name of the store/system where agent originated. For example `Copilot Studio`.
ownerIds	String collection	List of object IDs for the owners of the agent instance.
preferredTransport	String	Preferred transport protocol. The possible values are `JSONRPC`, `GRPC`, and `HTTP+JSON`.
signatures	agentCardSignature collection	Digital signatures for the agent instance.
sourceAgentId	String	Identifier of the agent in the original source system.
url	String	Endpoint URL for the agent instance.

Table of Contents

AgentCollection.Read.All

Graph Methods

Resources