New command: `entra agent blueprint list`

[MartinM85]

Usage

m365 entra agent blueprint list [options]

Description

Retrieves a list of templates defining the agent identity type

Options

Option	Description
-p, --properties [properties]	Comma separated list of properties to be returned

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'

Default properties

• id
• displayName
• appId

Additional Info

Requires new permission: AgentIdentityBlueprint.Read.All

Doc: https://learn.microsoft.com/en-us/graph/api/agentidentityblueprint-list

Include in the remarks the important admonition from the docs:

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.

[Jwaegebaert]

Specs look good, one thing I feel like we should also include in the remarks is following important admonition from the docs:

• 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.

[MartinM85]

@Jwaegebaert Spec updated