You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: api-reference/beta/api/agentidentity-post.md
+3-3Lines changed: 3 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -38,7 +38,7 @@ POST /servicePrincipals/microsoft.graph.agentIdentity
38
38
| Content-Type | application/json. Required. |
39
39
40
40
## Request body
41
-
In the request body, supply a JSON representation of a [agentIdentity](../resources/agentidentity.md) object. The request body must contain **displayName**, **agentIdentityBlueprintAppId**, and a valid **sponsor** reference.
41
+
In the request body, supply a JSON representation of a [agentIdentity](../resources/agentidentity.md) object. The request body must contain **displayName**, **agentIdentityBlueprintId**, and a valid **sponsor** reference.
Represents an agent identity blueprint principal in a tenant. An agent identity blueprint principal is instantiated from an [agentIdentityBlueprintPrincipal](../resources/agentidentityblueprintprincipal.md) object and is used to create [agent identities](../resources/agentidentity.md) within a Microsoft Entra ID tenant, and perform various identity management operations that affect all agent identities created.
17
+
Represents an agent identity blueprint principal in a tenant. An agent identity blueprint principal is instantiated from an [agentIdentityBlueprint](../resources/agentidentityblueprint.md) object and is used to create [agent identities](../resources/agentidentity.md) within a Microsoft Entra ID tenant, and perform various identity management operations that affect all agent identities created.
18
18
19
19
Inherits from [servicePrincipal](../resources/serviceprincipal.md).
20
20
@@ -77,7 +77,7 @@ This resource is an open type that allows additional properties beyond those doc
77
77
|info|[informationalUrl](../resources/informationalurl.md)|Basic profile information of the acquired application such as app's marketing, support, terms of service and privacy statement URLs. The terms of service and privacy statement are surfaced to users through the user consent experience. Inherited from [servicePrincipal](../resources/serviceprincipal.md).|
78
78
|publishedPermissionScopes|[permissionScope](../resources/permissionscope.md) collection|The delegated permissions exposed by the application. For more information, see the **oauth2PermissionScopes** property on the agent identity blueprint entity's **api** property. Not nullable. Inherited from [servicePrincipal](../resources/serviceprincipal.md).|
79
79
|publisherName|String|The name of the Microsoft Entra tenant that published the application. Inherited from [servicePrincipal](../resources/serviceprincipal.md).|
80
-
|servicePrincipalNames|String collection|Contains the list of **identifiersUris**, copied over from the associated agent identity blueprint. More values can be added to hybrid agent identity blueprint. These values can be used to identify the permissions exposed by this app within Microsoft Entra ID. Not nullable. **Property blocked on Agent Identity Blueprint Principal.** Inherited from [servicePrincipal](../resources/serviceprincipal.md).|
80
+
|servicePrincipalNames|String collection|Read-only **identifierUris**used to identify the permissions exposed by this app within Microsoft Entra ID. Not nullable. **Property blocked on Agent Identity Blueprint Principal**. Inherited from [servicePrincipal](../resources/serviceprincipal.md).|
81
81
|servicePrincipalType|String|Identifies if the agent identity blueprint principal represents an application. This is set by Microsoft Entra ID internally. For an agent identity blueprint principal that represents an application this is set as __Application__. Inherited from [servicePrincipal](../resources/serviceprincipal.md).|
82
82
|signInAudience|String|Specifies the Microsoft accounts that are supported for the current agent identity blueprint. Read-only. Supported values are: `AzureADMyOrg`, `AzureADMultipleOrgs`, `AzureADandPersonalMicrosoftAccount`, and `PersonalMicrosoftAccount`. Inherited from [servicePrincipal](../resources/serviceprincipal.md).|
83
83
|tags|String collection|Custom strings that can be used to categorize and identify the agent identity blueprint principal. Not nullable. The value is the union of strings set here and on the associated agent identity blueprint entity's **tags** property. Inherited from [servicePrincipal](../resources/serviceprincipal.md).|
description: "Represents an agent identity blueprint principal in a directory. An Agent Identity Blueprint principal is a specialized service principal that serves as the parent blueprint for creating agent identity instances within the Microsoft Entra ID ecosystem."
4
4
author: "zallison22"
5
-
ms.date: 02/26/2026
5
+
ms.date: 04/16/2026
6
6
ms.localizationpriority: medium
7
7
ms.subservice: "entra-agent-id"
8
8
doc_type: resourcePageType
@@ -12,7 +12,7 @@ doc_type: resourcePageType
12
12
13
13
Namespace: microsoft.graph
14
14
15
-
Represents an agent identity blueprint principal in a tenant. An agent identity blueprint principal is instantiated from an [agentIdentityBlueprintPrincipal](../resources/agentidentityblueprintprincipal.md) object and is used to create [agent identities](../resources/agentidentity.md) within a Microsoft Entra ID tenant, and perform various identity management operations that affect all agent identities created.
15
+
Represents an agent identity blueprint principal in a tenant. An agent identity blueprint principal is instantiated from an [agentIdentityBlueprint](../resources/agentidentityblueprint.md) object and is used to create [agent identities](../resources/agentidentity.md) within a Microsoft Entra ID tenant, and perform various identity management operations that affect all agent identities created.
16
16
17
17
Inherits from [servicePrincipal](../resources/serviceprincipal.md).
0 commit comments