AgentIdentityBlueprint.Create | Graph Permissions

Permission Details

Application Permission

Create agent identity blueprints.

Allows creating new agent identity blueprints without a signed-in user.

Permission ID: ea4b2453-ad2d-4d94-9155-10d5d9493ce9

Delegated Permission

Create agent identity blueprints.

Allows creating new agent identity blueprints with a signed-in user.

Permission ID: 8fc15edd-ba24-494e-9bf6-d38e1b7ba8fd

Properties

Microsoft Graph v1.0 exact-category-docs

Properties is shown from stable Microsoft Graph v1.0 metadata.

Property	Type	Description
`api`	`apiApplication`	Specifies settings for an agent identity blueprint that implements a web API. Inherited from application.
`appId`	`String`Nullable	The unique identifier for the agent identity blueprint that is assigned by Microsoft Entra ID. Not nullable. Read-only. Inherited from application.
`appRoles`	`appRole collection`	The collection of roles defined for the agent identity blueprint. With app role assignments, these roles can be assigned to users, groups, or service principals associated with other applications. Not nullable. Inherited from application.
`certification`	`certification`	Specifies the certification status of the agent identity blueprint. Inherited from application.
`createdByAppId`	`String`Nullable	The appId of the application that created this agent identity blueprint. Set internally by Microsoft Entra ID. Read-only. Inherited from application.
`createdDateTime`	`DateTimeOffset`Nullable	The date and time the agent identity blueprint was registered. The DateTimeOffset type represents date and time information using ISO 8601 format and is always in UTC time. Read-only. Inherited from application.
`description`	`String`Nullable	Free text field to provide a description of the agent identity blueprint to end users. The maximum allowed size is 1,024 characters. The least privileged permission to update this property is AgentIdentityBlueprint.UpdateBranding.All. Inherited from application.
`disabledByMicrosoftStatus`	`String`Nullable	Specifies whether Microsoft has disabled the registered agent identity blueprint. The possible values are: null (default value), NotDisabled, and DisabledDueToViolationOfServicesAgreement (reasons may include suspicious, abusive, or malicious activity, or a violation of the Microsoft Services Agreement). Inherited from application.
`displayName`	`String`Nullable	The display name for the agent identity blueprint. Maximum length is 256 characters. The least privileged permission to update this property is AgentIdentityBlueprint.UpdateBranding.All. Inherited from application.
`groupMembershipClaims`	`String`Nullable	Configures the groups claim issued in a user or OAuth 2.0 access token that the agent identity blueprint expects. To set this attribute, use one of the following string values: None, SecurityGroup (for security groups and Microsoft Entra roles), All (this gets all security groups, distribution groups, and Microsoft Entra directory roles that the signed-in user is a member of). Inherited from application.
`id`	`String`	Unique identifier for the agent identity blueprint object. This property is referred to as Object ID in the Microsoft Entra admin center. Key. Not nullable. Read-only. Inherited from directoryObject.
`identifierUris`	`String collection`	Also known as App ID URI, this value is set when an agent identity blueprint is used as a resource app. The identifierUris acts as the prefix for the scopes you reference in your API's code, and it must be globally unique across Microsoft Entra ID. Not nullable. Inherited from application.
`info`	`informationalUrl`	Basic profile information of the agent identity blueprint, such as it'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 application.
`keyCredentials`	`keyCredential collection`	The collection of key credentials associated with the agent identity blueprint. Not nullable. The least privileged permission to update this property is AgentIdentityBlueprint.AddRemoveCreds.All. Inherited from application.
`managerApplications`	`Guid collection`	A collection of application IDs for Microsoft first-party applications designated as managers of this agent blueprint. Manager applications can create agent blueprint principals, agent identities, and agent users for managed agent blueprints without requiring highly privileged permissions such as AgentIdentityBlueprintPrincipal.ReadWrite.All. Limited to a maximum of 10 entries. Not nullable. Only Microsoft first-party applications can be designated as managers. Not returned by default. Supports $select.

Showing 15 of 55 properties.

JSON Representation

Microsoft Graph v1.0 exact-category-docs

JSON representation is shown from stable Microsoft Graph v1.0 metadata.

JSON representation

{
  "@odata.type": "#microsoft.graph.agentIdentityBlueprint",
  "id": "String (identifier)",
  "appId": "String",
  "identifierUris": [
    "String"
  ],
  "createdByAppId": "String",
  "createdDateTime": "String (timestamp)",
  "description": "String",
  "disabledByMicrosoftStatus": "String",
  "displayName": "String",
  "groupMembershipClaims": "String",
  "publisherDomain": "String",
  "requiredResourceAccess": [
    {
      "@odata.type": "microsoft.graph.requiredResourceAccess"
    }
  ],
  "signInAudience": "String",
  "tags": [
    "String"
  ],
  "tokenEncryptionKeyId": "Guid",
  "uniqueName": "String",
  "serviceManagementReference": "String",
  "certification": {
    "@odata.type": "microsoft.graph.certification"
  },
  "optionalClaims": {
    "@odata.type": "microsoft.graph.optionalClaims"
  },
  "api": {
    "@odata.type": "microsoft.graph.apiApplication"
  },
  "appRoles": [
    {
      "@odata.type": "microsoft.graph.appRole"
    }
  ],
  "info": {
    "@odata.type": "microsoft.graph.informationalUrl"
  },
  "keyCredentials": [
    {
      "@odata.type": "microsoft.graph.keyCredential"
    }
  ],
  "managerApplications": [
    "Guid"
  ],
  "passwordCredentials": [
    {
      "@odata.type": "microsoft.graph.passwordCredential"
    }
  ],
  "verifiedPublisher": {
    "@odata.type": "microsoft.graph.verifiedPublisher"
  },
  "web": {
    "@odata.type": "microsoft.graph.webApplication"
  }
}

Relationships

Microsoft Graph v1.0 exact-category-docs

Relationships is shown from stable Microsoft Graph v1.0 metadata.

Relationship	Type	Description
`appManagementPolicies`	`appManagementPolicy collection`	The appManagementPolicy applied to this agent identity blueprint. Inherited from microsoft.graph.application
`federatedIdentityCredentials`	`federatedIdentityCredential collection`	Federated identities for agent identity blueprints. Inherited from microsoft.graph.application
`inheritablePermissions`	`inheritablePermission collection`	Defines scopes of a resource application that may be automatically granted to agent identities without additional consent.
`owners`	`directoryObject collection`	Directory objects that are owners of this agent identity blueprint. The owners are a set of nonadmin users or service principals allowed to modify this object. Read-only. Nullable. Inherited from microsoft.graph.application
`sponsors`	`directoryObject collection`	The sponsors for this agent identity blueprint. Sponsors are users or groups who can authorize and manage the lifecycle of agent identity instances. Required during the create operation.
`addIns`	`addIn collection`	Defines custom behavior that a consuming service can use to call an app in specific contexts. For example, applications that can render file streams can set the addIns property for its 'FileHandler' functionality. This lets services like Microsoft 365 call the application in the context of a document the user is working on.
`appRoles`	`appRole collection`	The collection of roles defined for the application. With app role assignments, these roles can be assigned to users, groups, or service principals associated with other applications. Not nullable.
`extensionProperties`	`extensionProperty collection`	Read-only. Nullable. Supports $expand and $filter (/$count eq 0, /$count ne 0).
`homeRealmDiscoveryPolicies`	`homeRealmDiscoveryPolicy collection`	Related homeRealmDiscoveryPolicies data exposed by this resource.
`identifierUris`	`string collection`	Also known as App ID URI, this value is set when an application is used as a resource app. The identifierUris acts as the prefix for the scopes you reference in your API's code, and it must be globally unique across Microsoft Entra ID. For more information on valid identifierUris patterns and best practices, see Microsoft Entra application registration security best practices. Not nullable. Supports $filter (eq, ne, ge, le, startsWith).
`keyCredentials`	`keyCredential collection`	The collection of key credentials associated with the application. Not nullable. Supports $filter (eq, not, ge, le).
`managerApplications`	`string collection`	A collection of application IDs for Microsoft first-party applications designated as managers. Manager applications can create service principals, agent identities, and agent users for managed agent blueprints. Limited to a maximum of 10 entries. Not nullable. Only supported on agentIdentityBlueprint objects; attempts to set this property on non-agent-blueprint applications return an error. Not returned by default; must be explicitly requested via $select.
`passwordCredentials`	`passwordCredential collection`	The collection of password credentials associated with the application. Not nullable.
`requiredResourceAccess`	`requiredResourceAccess collection`	Specifies the resources that the application needs to access. This property also specifies the set of delegated permissions and application roles that it needs for each of those resources. This configuration of access to the required resources drives the consent experience. No more than 50 resource services (APIs) can be configured. Beginning mid-October 2021, the total number of required permissions must not exceed 400. For more information, see Limits on requested permissions per app. Not nullable. Supports $filter (eq, not, ge, le).
`tags`	`string collection`	Custom strings that can be used to categorize and identify the application. Not nullable. Strings added here will also appear in the tags property of any associated service principals.Supports $filter (eq, not, ge, le, startsWith) and $search.
`tokenEncryptionKeyId`	`uuid`	Specifies the keyId of a public key from the keyCredentials collection. When configured, Microsoft Entra ID encrypts all the tokens it emits by using the key this property points to. The application code that receives the encrypted token must use the matching private key to decrypt the token before it can be used for the signed-in user.
`tokenIssuancePolicies`	`tokenIssuancePolicy collection`	Related tokenIssuancePolicies data exposed by this resource.
`tokenLifetimePolicies`	`tokenLifetimePolicy collection`	Related tokenLifetimePolicies data exposed by this resource.
`signInAudienceRestrictions`	`signInAudienceRestrictionsBase`	Related signInAudienceRestrictions data exposed by this resource.

Graph Methods

Delegated access App-only access

Exact Microsoft Learn match

Microsoft Graph v1.0 endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
POST `/applications/{id}/microsoft.graph.agentIdentityBlueprint/inheritablePermissions`
POST `/applications/microsoft.graph.agentIdentityBlueprint`

Exact Microsoft Learn match

Microsoft Graph beta endpoints are mapped directly from refreshed Microsoft Learn permissions tables.

Methods
POST `/applications(appId='{appId}')/federatedIdentityCredentials`
POST `/applications/{id}/federatedIdentityCredentials`
POST `/applications/{id}/microsoft.graph.agentIdentityBlueprint/federatedIdentityCredentials`
POST `/applications/{id}/microsoft.graph.agentIdentityBlueprint/inheritablePermissions`
POST `/applications/microsoft.graph.agentIdentityBlueprint`

Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell v1.0 commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

No deterministic PowerShell command map is available for this permission.

Browse PowerShell docs

Exact Microsoft Learn PowerShell match

Microsoft Graph PowerShell beta commands are mapped directly from refreshed Microsoft Learn PowerShell snippets.

Commands
`New-MgBetaApplicationFederatedIdentityCredential` /applications/{id}/federatedIdentityCredentials Create federatedIdentityCredential

Code Examples

C# / .NET SDK

Create federatedIdentityCredential

View official example on Microsoft Learn

// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Beta.Models;

var requestBody = new FederatedIdentityCredential
{
	Name = "testing02",
	Issuer = "https://login.microsoftonline.com/3d1e2be9-a10a-4a0c-8380-7ce190f98ed9/v2.0",
	Subject = "a7d388c3-5e3f-4959-ac7d-786b3383006a",
	Audiences = new List<string>
	{
		"api://AzureADTokenExchange",
	},
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Applications["{application-id}"].FederatedIdentityCredentials.PostAsync(requestBody);

JavaScript

Create inheritablePermission

View official example on Microsoft Learn

const options = {
	authProvider,
};

const client = Client.init(options);

const inheritablePermission = {
  resourceAppId: '00000003-0000-0000-c000-000000000000',
  inheritableScopes: {
    '@odata.type': 'microsoft.graph.allAllowedScopes'
  }
};

await client.api('/applications/bc057821-f236-49d6-9f2c-1ebf43e9437a/microsoft.graph.agentIdentityBlueprint/inheritablePermissions')
	.post(inheritablePermission);

PowerShell

Create federatedIdentityCredential

View official example on Microsoft Learn

Import-Module Microsoft.Graph.Beta.Applications

$params = @{
	name = "testing02"
	issuer = "https://login.microsoftonline.com/3d1e2be9-a10a-4a0c-8380-7ce190f98ed9/v2.0"
	subject = "a7d388c3-5e3f-4959-ac7d-786b3383006a"
	audiences = @(
	"api://AzureADTokenExchange"
)
}

New-MgBetaApplicationFederatedIdentityCredential -ApplicationId $applicationId -BodyParameter $params

Python

Create federatedIdentityCredential

View official example on Microsoft Learn

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.models.federated_identity_credential import FederatedIdentityCredential
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = FederatedIdentityCredential(
	name = "testing02",
	issuer = "https://login.microsoftonline.com/3d1e2be9-a10a-4a0c-8380-7ce190f98ed9/v2.0",
	subject = "a7d388c3-5e3f-4959-ac7d-786b3383006a",
	audiences = [
		"api://AzureADTokenExchange",
	],
)

result = await graph_client.applications.by_application_id('application-id').federated_identity_credentials.post(request_body)

App Registration

1

Navigate to Azure Portal

Go to App registrations in Microsoft Entra admin center

2

Add API Permission

Select your app → API permissions → Add a permission → Microsoft Graph

3

Select Permission Type

Choose Application permissions or delegated permissions and search for AgentIdentityBlueprint.Create

4

Grant Admin Consent

Application permissions always require admin consent.