Skip to main content

entra agent blueprint list

Retrieves a list of templates defining the agent identity type

Usage​

m365 entra agent blueprint list [options]

Options​

-p, --properties [properties]

Comma-separated list of properties to retrieve.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, permissions, response, full. Default is options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks​

Using the --properties option, you can specify a comma-separated list of agent blueprint properties to retrieve from Microsoft Graph. If you don't specify any properties, Microsoft Graph returns its default property set, as shown in the response examples. The CLI's default properties are used only for text output.

note

A principal who creates a blueprint or blueprint principal is assigned as the owner. Owners can create agent identities and modify only the resources they own, even if they aren't assigned an Agent ID role.

For nonowners to call this API in delegated scenarios using work or school accounts, the admin must be assigned a supported Microsoft Entra role. This operation supports the following built-in roles, which provide only the least privilege necessary:

  • Agent ID Administrator.
  • Agent ID Developer - Create agent identity blueprints and blueprint principals.

Permissions​

ResourcePermissions
Microsoft GraphAgentIdentityBlueprint.Read.All

Examples​

Retrieve all agent blueprint templates

m365 entra agent blueprint list

Retrieve id and name of agent blueprint templates

m365 entra agent blueprint list --properties 'id,displayName'

Response​

[
  {
    "appId": "0e81af7f-b058-470a-84be-3a4f5a8014ca",
    "createdByAppId": "14d82eec-204b-4c2f-b7e8-296a70dab67e",
    "createdDateTime": "2025-11-20T07:47:39Z",
    "defaultRedirectUri": null,
    "description": null,
    "disabledByMicrosoftStatus": null,
    "displayName": "OcnAgentBluePrint02",
    "groupMembershipClaims": null,
    "identifierUris": [],
    "managerApplications": [],
    "publisherDomain": "contoso.onmicrosoft.com",
    "serviceManagementReference": null,
    "signInAudience": "AzureADMyOrg",
    "tags": [],
    "tokenEncryptionKeyId": null,
    "uniqueName": null,
    "id": "0e81af7f-b058-470a-84be-3a4f5a8014ca",
    "certification": null,
    "optionalClaims": null,
    "api": {
      "acceptMappedClaims": null,
      "knownClientApplications": [],
      "requestedAccessTokenVersion": 2,
      "oauth2PermissionScopes": [],
      "preAuthorizedApplications": []
    },
    "appRoles": [],
    "info": {
      "logoUrl": null,
      "marketingUrl": null,
      "privacyStatementUrl": null,
      "supportUrl": null,
      "termsOfServiceUrl": null
    },
    "keyCredentials": [],
    "passwordCredentials": [],
    "requiredResourceAccess": [],
    "verifiedPublisher": {
      "displayName": null,
      "verifiedPublisherId": null,
      "addedDateTime": null
    },
    "web": {
      "homePageUrl": null,
      "logoutUrl": null,
      "redirectUris": [],
      "implicitGrantSettings": {
        "enableAccessTokenIssuance": false,
        "enableIdTokenIssuance": false
      },
      "redirectUriSettings": []
    }
  }
]