Skip to content

agentcollection-list-members.md

Latest commit

 

History

History
123 lines (94 loc) · 4.17 KB

agentcollection-list-members.md

File metadata and controls

123 lines (94 loc) · 4.17 KB
title List agentCollection members
description Return the list of agent instance members for the specified collection.
author jasondou
ms.date 11/06/2025
ms.localizationpriority medium
ms.subservice entra-id
doc_type apiPageType

List agentCollection members

Namespace: microsoft.graph

[!INCLUDE beta-disclaimer]

Return the list of agent instances that are members for the specified agentCollection. This API returns only the agentCollection and doesn't support using $select to return other properties. Attempting to select more properties returns a 400 Bad Request error code.

Permissions

Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.

[!INCLUDE permissions-table]

Important

In addition to the permissions listed in the preceding table, the following lesser-privileged permissions scoped to the special collections are supported for this API:

  • AgentCollection.Read.Global and AgentCollection.ReadWrite.Global for the Global collection
  • AgentCollection.Read.Quarantined and AgentCollection.ReadWrite.Quarantined for the Quarantined collection

[!INCLUDE rbac-agentregistry-apis]

HTTP request

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

Optional query parameters

This method supports the $select and $count OData query parameters to help customize the response. For general information, see OData query parameters.

Request headers

Name Description
Authorization Bearer {token}. Required. Learn more about authentication and authorization.

Request body

Don't supply a request body for this method.

Response

If successful, this method returns a 200 OK response code and a collection of agentInstance objects in the response body.

Examples

Request

The following example shows a request.

HTTP

GET https://graph.microsoft.com/beta/agentRegistry/agentInstances/{agentInstanceId}/collections/{agentCollectionId}/members

JavaScript

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Response

The following example shows the response.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "Security Copilot Platform Agent: 00123",
      "managedBy": "719cc904-9700-4e08-9941-fd826cc84c60",
      "originatingStore": "Microsoft Security Copilot",
      "displayName": "Conditional Access Agent",
      "agentIdentityBlueprintId": "cc08c41-d2d2-4e78-b073-92f57b752bd0",
      "agentIdentityId": "cd108c41-d2d2-4e78-b073-92f57b752bd0",
      "agentUserId": null
    },
    {
      "id": "Security Copilot Platform Agent: 00222",
      "managedBy": "719cc904-9700-4e08-9941-fd826cc84c60",
      "originatingStore": "Microsoft Security Copilot",
      "displayName": "Conditional Access Agent",
      "agentIdentityBlueprintId": "ab108c41-d2d2-4e78-b073-92f57b752bd0",
      "agentIdentityId": "ac108c41-d2d2-4e78-b073-92f57b752bd0",
      "agentUserId": null
    }
  ]
}