ESC
Type to search...
↑↓ Navigate ↵ Open ESC Close

AgentIdUser.ReadWrite.IdentityParentedBy

Export JSON
Export CSV
Copy URL
Print
ApplicationDelegated Read/Write User Scope

Allows the app to read and update ID agent user profiles and read basic company properties without a signed in user.

Permission data: April 6, 2026 at 4:06 AM UTC
Delegated Access App-Only Access

Permission Details

Application Permission

Read and write all agent ID users' full profiles

Allows the app to read and update ID agent user profiles and read basic company properties without a signed in user.

Permission ID: 4aa6e624-eee0-40ab-bdd8-f9639038a614
Delegated Permission Admin consent required

Read and write all agent ID users' full profiles

Allows the app to read and write the full set of profile properties, reports, and managers of agent ID users in your organization, and read basic company properties, on behalf of the signed-in user.

User sees: Allows the app to read and write the full set of profile properties, reports, and managers of agent ID users in your organization, and read basic company properties, on your behalf.
Permission ID: 52a417d9-0b3c-4466-9a3b-66960de73d74

Properties

Microsoft Graph v1.0 endpoint-derived-docs

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

Property Type Description
edge object A container for Microsoft Edge resources. Read-only.
exchange object A container for the Exchange admin functionality. Read-only.
microsoft365Apps object A container for the Microsoft 365 apps admin functionality.
people object Represents a setting to control people-related admin settings in the tenant.
reportSettings object A container for administrative resources to manage reports.
serviceAnnouncement object A container for service communications resources. Read-only.
sharepoint object
teams object A container for Teams administration functionalities, such as Teams telephone number management functionalities, user Teams configurations, and policy assignments.

JSON Representation

Microsoft Graph v1.0 endpoint-derived-docs

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

JSON representation 
{
  "@odata.type": "#microsoft.graph.admin"
}

Relationships

Microsoft Graph v1.0 endpoint-derived-docs

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

Relationship Type Description
configurationManagement configurationManagement A container for Tenant Configuration Management (TCM) resources. Read-only.
edge edge A container for Microsoft Edge resources. Read-only.
exchange exchangeAdmin A container for the Exchange admin functionality. Read-only.
microsoft365Apps adminMicrosoft365Apps A container for the Microsoft 365 apps admin functionality.
people peopleAdminSettings Represents a setting to control people-related admin settings in the tenant.
reportSettings adminReportSettings A container for administrative resources to manage reports.
serviceAnnouncement serviceAnnouncement A container for service communications resources. Read-only.
sharepointSettings sharepointSettings A container for administrative resources to manage tenant-level settings for SharePoint and OneDrive.
teams teamsAdministration.teamsAdminRoot A container for Teams administration functionalities, such as Teams telephone number management functionalities, user Teams configurations, and policy assignments.

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
GET /admin/people/itemInsights
GET /me/createdObjects
GET /me/joinedTeams
GET /me/licenseDetails
GET /me/manager
GET /me/ownedObjects
GET /me/settings/
GET /users?$expand=manager
GET /users/{id | user-principal-name}/joinedTeams
GET /users/{id | userPrincipalName}/?$expand=manager($levels=n)
GET /users/{id | userPrincipalName}/createdObjects
GET /users/{id | userPrincipalName}/manager
GET /users/{id | userPrincipalName}/ownedObjects
GET /users/{id | userPrincipalName}/settings/
GET /users/{id | userPrincipalName}/sponsors
GET /users/{id}/licenseDetails
GET /users/{userId}/settings/shiftPreferences
GET /users/delta
POST /me/revokeSignInSessions
POST /me/translateExchangeIds
POST /users/{id | userPrincipalName}/assignLicense
POST /users/{id | userPrincipalName}/revokeSignInSessions
POST /users/{id}/reprocessLicenseAssignment
POST /users/{id}/sponsors/$ref
POST /users/{id|userPrincipalName}/translateExchangeIds
PATCH /me/settings
PATCH /users/{id | userPrincipalName}/settings/
PATCH /users/{userId}/settings/shiftPreferences
PUT /users/{id}/manager/$ref
DELETE /users/{id}/manager/$ref
DELETE /users/{id}/sponsors/{id}/$ref
Exact Microsoft Learn match

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

Methods
GET /admin/people/itemInsights
GET /me/createdObjects
GET /me/joinedTeams
GET /me/licenseDetails
GET /me/manager
GET /me/ownedObjects
GET /me/profile
GET /me/profile/account
GET /me/profile/account/{id}
GET /me/profile/addresses
GET /me/profile/addresses/{id}
GET /me/profile/anniversaries
GET /me/profile/anniversaries/{id}
GET /me/profile/awards
GET /me/profile/awards/{id}
GET /me/profile/certifications
GET /me/profile/certifications/{id}
GET /me/profile/educationalActivities
GET /me/profile/educationalActivities/{id}
GET /me/profile/emails
GET /me/profile/emails/{id}
GET /me/profile/interests
GET /me/profile/interests/{id}
GET /me/profile/languages
GET /me/profile/languages/{id}
GET /me/profile/names
GET /me/profile/names/{id}
GET /me/profile/notes
GET /me/profile/notes/{id}
GET /me/profile/patents
GET /me/profile/patents/{id}
GET /me/profile/phones
GET /me/profile/phones/{id}
GET /me/profile/positions
GET /me/profile/positions/{id}
GET /me/profile/projects
GET /me/profile/projects/{id}
GET /me/profile/publications
GET /me/profile/publications/{id}
GET /me/profile/skills
GET /me/profile/skills/{id}
GET /me/profile/webAccounts
GET /me/profile/webAccounts/{id}
GET /me/profile/websites
GET /me/profile/websites/{id}
GET /me/responsibilities
GET /me/responsibilities/{id}
GET /me/settings/
GET /organization/{organizationId}/settings/itemInsights
GET /organization/{organizationId}/settings/peopleInsights
GET /users?$expand=manager
GET /users/{id | user-principal-name}/joinedTeams
GET /users/{id | userPrincipalName}/?$expand=manager($levels=n)
GET /users/{id | userPrincipalName}/createdObjects
GET /users/{id | userPrincipalName}/manager
GET /users/{id | userPrincipalName}/ownedObjects
GET /users/{id | userPrincipalName}/profile
GET /users/{id | userPrincipalName}/profile/account
GET /users/{id | userPrincipalName}/profile/account/{id}
GET /users/{id | userPrincipalName}/profile/addresses
GET /users/{id | userPrincipalName}/profile/addresses/{id}
GET /users/{id | userPrincipalName}/profile/anniversaries
GET /users/{id | userPrincipalName}/profile/anniversaries/{id}
GET /users/{id | userPrincipalName}/profile/awards
GET /users/{id | userPrincipalName}/profile/awards/{id}
GET /users/{id | userPrincipalName}/profile/certifications
GET /users/{id | userPrincipalName}/profile/certifications/{id}
GET /users/{id | userPrincipalName}/profile/educationalActivities
GET /users/{id | userPrincipalName}/profile/educationalActivities/{id}
GET /users/{id | userPrincipalName}/profile/emails
GET /users/{id | userPrincipalName}/profile/emails/{id}
GET /users/{id | userPrincipalName}/profile/interests
GET /users/{id | userPrincipalName}/profile/interests/{id}
GET /users/{id | userPrincipalName}/profile/languages
GET /users/{id | userPrincipalName}/profile/languages/{id}
GET /users/{id | userPrincipalName}/profile/names
GET /users/{id | userPrincipalName}/profile/names/{id}
GET /users/{id | userPrincipalName}/profile/notes
GET /users/{id | userPrincipalName}/profile/notes/{id}
GET /users/{id | userPrincipalName}/profile/patents
GET /users/{id | userPrincipalName}/profile/patents/{id}
GET /users/{id | userPrincipalName}/profile/phones
GET /users/{id | userPrincipalName}/profile/positions
GET /users/{id | userPrincipalName}/profile/positions/{id}
GET /users/{id | userPrincipalName}/profile/projects
GET /users/{id | userPrincipalName}/profile/projects/{id}
GET /users/{id | userPrincipalName}/profile/publications
GET /users/{id | userPrincipalName}/profile/publications/{id}
GET /users/{id | userPrincipalName}/profile/skills
GET /users/{id | userPrincipalName}/profile/skills/{id}
GET /users/{id | userPrincipalName}/profile/webAccounts
GET /users/{id | userPrincipalName}/profile/webAccounts/{id}
GET /users/{id | userPrincipalName}/profile/websites
GET /users/{id | userPrincipalName}/profile/websites/{id}
GET /users/{id | userPrincipalName}/responsibilities
GET /users/{id | userPrincipalName}/responsibilities/{id}
GET /users/{id | userPrincipalName}/settings/
GET /users/{id | userPrincipalName}/sponsors
GET /users/{id}/licenseDetails
GET /users/{userId}/profile/phones/{id}
GET /users/{userId}/settings/shiftPreferences
GET /users/{userId}/usageRights
GET /users/{usersId}/directReports
GET /users/{usersId}/manager
GET /users/{usersId}/memberOf
GET /users/{usersId}/ownedObjects
GET /users/{usersId}/sponsors
GET /users/{usersId}/transitiveMemberOf
GET /users/{usersId}/transitiveReports/$count
GET /users/delta
GET /users/microsoft.graph.AgentUser
GET /users/microsoft.graph.agentUser/{userId}
POST /me/profile/account
POST /me/profile/addresses
POST /me/profile/anniversaries
POST /me/profile/awards
POST /me/profile/certifications
POST /me/profile/educationalActivities
POST /me/profile/emails
POST /me/profile/interests
POST /me/profile/languages
POST /me/profile/names
POST /me/profile/notes
POST /me/profile/patents
POST /me/profile/phones
POST /me/profile/positions
POST /me/profile/projects
POST /me/profile/publications
POST /me/profile/skills
POST /me/profile/webAccounts
POST /me/profile/websites
POST /me/responsibilities
POST /me/revokeSignInSessions
POST /me/translateExchangeIds
POST /users/{id | userPrincipalName}/assignLicense
POST /users/{id | userPrincipalName}/profile/account
POST /users/{id | userPrincipalName}/profile/addresses
POST /users/{id | userPrincipalName}/profile/anniversaries
POST /users/{id | userPrincipalName}/profile/awards
POST /users/{id | userPrincipalName}/profile/certifications
POST /users/{id | userPrincipalName}/profile/educationalActivities
POST /users/{id | userPrincipalName}/profile/emails
POST /users/{id | userPrincipalName}/profile/interests
POST /users/{id | userPrincipalName}/profile/languages
POST /users/{id | userPrincipalName}/profile/names
POST /users/{id | userPrincipalName}/profile/notes
POST /users/{id | userPrincipalName}/profile/patents
POST /users/{id | userPrincipalName}/profile/positions
POST /users/{id | userPrincipalName}/profile/projects
POST /users/{id | userPrincipalName}/profile/publications
POST /users/{id | userPrincipalName}/profile/skills
POST /users/{id | userPrincipalName}/profile/webAccounts
POST /users/{id | userPrincipalName}/profile/websites
POST /users/{id | userPrincipalName}/responsibilities
POST /users/{id | userPrincipalName}/revokeSignInSessions
POST /users/{id}/reprocessLicenseAssignment
POST /users/{id}/sponsors/$ref
POST /users/{id|userPrincipalName}/translateExchangeIds
POST /users/{userId}/profile/phones
POST /users/{usersId}/manager/$ref
POST /users/{usersId}/sponsors/$ref
POST /users/microsoft.graph.agentUser
PATCH /admin/people/itemInsights
PATCH /me/profile/account/{id}
PATCH /me/profile/addresses/{id}
PATCH /me/profile/anniversaries/{id}
PATCH /me/profile/awards/{id}
PATCH /me/profile/certifications/{id}
PATCH /me/profile/educationalActivities/{id}
PATCH /me/profile/emails/{id}
PATCH /me/profile/interests/{id}
PATCH /me/profile/languages/{id}
PATCH /me/profile/names/{id}
PATCH /me/profile/notes/{id}
PATCH /me/profile/patents/{id}
PATCH /me/profile/phones/{id}
PATCH /me/profile/positions/{id}
PATCH /me/profile/projects/{id}
PATCH /me/profile/publications/{id}
PATCH /me/profile/skills/{id}
PATCH /me/profile/webAccounts/{id}
PATCH /me/profile/websites/{id}
PATCH /me/responsibilities/{id}
PATCH /me/settings
PATCH /organization/{organizationId}/settings/contactInsights
PATCH /organization/{organizationId}/settings/peopleInsights
PATCH /users/{id | userPrincipalName}/profile/account/{id}
PATCH /users/{id | userPrincipalName}/profile/addresses/{id}
PATCH /users/{id | userPrincipalName}/profile/anniversaries/{id}
PATCH /users/{id | userPrincipalName}/profile/awards/{id}
PATCH /users/{id | userPrincipalName}/profile/certifications/{id}
PATCH /users/{id | userPrincipalName}/profile/educationalActivities/{id}
PATCH /users/{id | userPrincipalName}/profile/emails/{id}
PATCH /users/{id | userPrincipalName}/profile/interests/{id}
PATCH /users/{id | userPrincipalName}/profile/languages/{id}
PATCH /users/{id | userPrincipalName}/profile/names/{id}
PATCH /users/{id | userPrincipalName}/profile/notes/{id}
PATCH /users/{id | userPrincipalName}/profile/patents/{id}
PATCH /users/{id | userPrincipalName}/profile/positions/{id}
PATCH /users/{id | userPrincipalName}/profile/projects/{id}
PATCH /users/{id | userPrincipalName}/profile/publications/{id}
PATCH /users/{id | userPrincipalName}/profile/skills/{id}
PATCH /users/{id | userPrincipalName}/profile/webAccounts/{id}
PATCH /users/{id | userPrincipalName}/profile/websites/{id}
PATCH /users/{id | userPrincipalName}/responsibilities/{id}
PATCH /users/{id | userPrincipalName}/settings/
PATCH /users/{userId}/profile/phones/{id}
PATCH /users/microsoft.graph.agentUser/{userId}
PUT /users/{id}/manager/$ref
PUT /users/{userId}/settings/shiftPreferences
DELETE /me/profile
DELETE /me/profile/account/{id}
DELETE /me/profile/addresses/{id}
DELETE /me/profile/anniversaries/{id}
DELETE /me/profile/awards/{id}
DELETE /me/profile/certifications/{id}
DELETE /me/profile/educationalActivities/{id}
DELETE /me/profile/emails/{id}
DELETE /me/profile/interests/{id}
DELETE /me/profile/languages/{id}
DELETE /me/profile/names/{id}
DELETE /me/profile/notes/{id}
DELETE /me/profile/patents/{id}
DELETE /me/profile/phones/{itemPhoneId}
DELETE /me/profile/positions/{id}
DELETE /me/profile/projects/{id}
DELETE /me/profile/publications/{id}
DELETE /me/profile/skills/{id}
DELETE /me/profile/webAccounts/{id}
DELETE /me/profile/websites/{id}
DELETE /me/responsibilities/{id}
DELETE /users/{id | userPrincipalName}/profile
DELETE /users/{id | userPrincipalName}/profile/account/{id}
DELETE /users/{id | userPrincipalName}/profile/addresses/{id}
DELETE /users/{id | userPrincipalName}/profile/anniversaries/{id}
DELETE /users/{id | userPrincipalName}/profile/awards/{id}
DELETE /users/{id | userPrincipalName}/profile/certifications/{id}
DELETE /users/{id | userPrincipalName}/profile/educationalActivities/{id}
DELETE /users/{id | userPrincipalName}/profile/emails/{id}
DELETE /users/{id | userPrincipalName}/profile/interests/{id}
DELETE /users/{id | userPrincipalName}/profile/languages/{id}
DELETE /users/{id | userPrincipalName}/profile/names/{id}
DELETE /users/{id | userPrincipalName}/profile/notes/{id}
DELETE /users/{id | userPrincipalName}/profile/patents/{id}
DELETE /users/{id | userPrincipalName}/profile/positions/{id}
DELETE /users/{id | userPrincipalName}/profile/projects/{id}
DELETE /users/{id | userPrincipalName}/profile/publications/{id}
DELETE /users/{id | userPrincipalName}/profile/skills/{id}
DELETE /users/{id | userPrincipalName}/profile/webAccounts/{id}
DELETE /users/{id | userPrincipalName}/profile/websites/{id}
DELETE /users/{id | userPrincipalName}/responsibilities/{id}
DELETE /users/{id}/manager/$ref
DELETE /users/{id}/sponsors/{id}/$ref
DELETE /users/{userId}/profile/phones/{itemPhoneId}
DELETE /users/{usersId}/manager/{id}/$ref
DELETE /users/{usersId}/sponsors/{id}/$ref
DELETE /users/microsoft.graph.agentUser/{userId}
Exact Microsoft Learn PowerShell match

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

Commands
Get-MgAdminPeopleItemInsight /admin/people/itemInsights
List itemInsights
Get-MgUser /me/manager
List manager
Get-MgUserCreatedObject /users/{id | userPrincipalName}/createdObjects
List createdObjects
Get-MgUserDelta /users/delta
user: delta
Get-MgUserJoinedTeam /me/joinedTeams
List joinedTeams
Get-MgUserLicenseDetail /me/licenseDetails
List licenseDetails
Get-MgUserManager /me/manager
List manager
Get-MgUserOwnedObject /me/ownedObjects
List ownedObjects
Get-MgUserSetting /me/settings/
Get settings
Get-MgUserSettingShiftPreference /users/{userId}/settings/shiftPreferences
Get shiftPreferences
Get-MgUserSponsor /users/{id | userPrincipalName}/sponsors
List sponsors
Invoke-MgLicenseUser /users/{id}/reprocessLicenseAssignment
user: reprocessLicenseAssignment
Invoke-MgTranslateUserExchangeId /me/translateExchangeIds
user: translateExchangeIds
Remove-MgUserManagerByRef /users/{id}/manager/$ref
Remove manager
Set-MgUserLicense /users/{id | userPrincipalName}/assignLicense
user: assignLicense
Set-MgUserManagerByRef /users/{id}/manager/$ref
Assign manager
Update-MgUserSetting /me/settings
Update userSettings
Update-MgUserSettingShiftPreference /users/{userId}/settings/shiftPreferences
Update shiftPreferences
Exact Microsoft Learn PowerShell match

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

Commands
Get-MgBetaAdminPeopleItemInsight /admin/people/itemInsights
List itemInsights
Get-MgBetaOrganizationSettingItemInsight /organization/{organizationId}/settings/itemInsights
List itemInsights (deprecated)
Get-MgBetaOrganizationSettingPersonInsight /organization/{organizationId}/settings/peopleInsights
List peopleInsights
Get-MgBetaUser /me/manager
List manager
Get-MgBetaUser /users/microsoft.graph.AgentUser
List agentUser objects
Get-MgBetaUserCreatedObject /users/{id | userPrincipalName}/createdObjects
List createdObjects
Get-MgBetaUserDelta /users/delta
user: delta
Get-MgBetaUserDirectReport /users/{usersId}/directReports
List directReports (for agentUser)
Get-MgBetaUserJoinedTeam /me/joinedTeams
List joinedTeams
Get-MgBetaUserLicenseDetail /me/licenseDetails
List licenseDetails
Get-MgBetaUserManager /me/manager
List manager
Get-MgBetaUserManager /users/{usersId}/manager
List manager (for agentUser)
Get-MgBetaUserMemberOf /users/{usersId}/memberOf
List agentUser direct memberships
Get-MgBetaUserOwnedObject /me/ownedObjects
List ownedObjects
Get-MgBetaUserOwnedObject /users/{usersId}/ownedObjects
List ownedObjects (for agentUser)
Get-MgBetaUserProfile /me/profile
Get profile
Get-MgBetaUserProfileAccount /me/profile/account
List accounts
Get-MgBetaUserProfileAccount /me/profile/account/{id}
Get userAccountInformation
Get-MgBetaUserProfileAddress /me/profile/addresses
List addresses
Get-MgBetaUserProfileAddress /me/profile/addresses/{id}
Get itemAddress
Get-MgBetaUserProfileAnniversary /me/profile/anniversaries
List anniversaries
Get-MgBetaUserProfileAnniversary /me/profile/anniversaries/{id}
Get personAnniversary
Get-MgBetaUserProfileAward /me/profile/awards
List awards
Get-MgBetaUserProfileAward /me/profile/awards/{id}
Get personAward
Get-MgBetaUserProfileCertification /me/profile/certifications
List certifications
Get-MgBetaUserProfileCertification /me/profile/certifications/{id}
Get personCertification
Get-MgBetaUserProfileEducationalActivity /me/profile/educationalActivities
List educationalActivities
Get-MgBetaUserProfileEducationalActivity /me/profile/educationalActivities/{id}
Get educationalActivity
Get-MgBetaUserProfileEmail /me/profile/emails
List emails
Get-MgBetaUserProfileEmail /me/profile/emails/{id}
Get itemEmail
Get-MgBetaUserProfileInterest /me/profile/interests
List interests
Get-MgBetaUserProfileInterest /me/profile/interests/{id}
Get personInterest
Get-MgBetaUserProfileLanguage /me/profile/languages
List languages
Get-MgBetaUserProfileLanguage /me/profile/languages/{id}
Get languageProficiency
Get-MgBetaUserProfileName /me/profile/names
List names
Get-MgBetaUserProfileName /me/profile/names/{id}
Get personName
Get-MgBetaUserProfileNote /me/profile/notes
List notes
Get-MgBetaUserProfileNote /me/profile/notes/{id}
Get personAnnotation
Get-MgBetaUserProfilePatent /me/profile/patents
List patents
Get-MgBetaUserProfilePatent /me/profile/patents/{id}
Get itemPatent
Get-MgBetaUserProfilePhone /me/profile/phones
List phones
Get-MgBetaUserProfilePhone /me/profile/phones/{id}
Get itemPhone
Get-MgBetaUserProfilePosition /me/profile/positions
List positions
Get-MgBetaUserProfilePosition /me/profile/positions/{id}
Get workPosition
Get-MgBetaUserProfileProject /me/profile/projects
List projects
Get-MgBetaUserProfileProject /me/profile/projects/{id}
Get projectParticipation
Get-MgBetaUserProfilePublication /me/profile/publications
List publications
Get-MgBetaUserProfilePublication /me/profile/publications/{id}
Get itemPublication
Get-MgBetaUserProfileSkill /me/profile/skills
List skills
Get-MgBetaUserProfileSkill /me/profile/skills/{id}
Get skillProficiency
Get-MgBetaUserProfileWebAccount /me/profile/webAccounts
List webAccounts
Get-MgBetaUserProfileWebAccount /me/profile/webAccounts/{id}
Get webAccount
Get-MgBetaUserProfileWebsite /me/profile/websites
List websites
Get-MgBetaUserProfileWebsite /me/profile/websites/{id}
Get personWebsite
Get-MgBetaUserSettingShiftPreference /users/{userId}/settings/shiftPreferences
Get shiftPreferences
Get-MgBetaUserSponsor /users/{id | userPrincipalName}/sponsors
List sponsors
Get-MgBetaUserSponsor /users/{usersId}/sponsors
List sponsors (for agentUser)
Get-MgBetaUserTransitiveMemberOf /users/{usersId}/transitiveMemberOf
List an agent user's memberships (direct and transitive)
Get-MgBetaUserTransitiveReportCount /users/{usersId}/transitiveReports/$count
List transitiveReports (for agentUser)
Invoke-MgBetaLicenseUser /users/{id}/reprocessLicenseAssignment
user: reprocessLicenseAssignment
Invoke-MgBetaTranslateUserExchangeId /me/translateExchangeIds
user: translateExchangeIds
New-MgBetaUserProfileAccount /me/profile/account
Create account
New-MgBetaUserProfileAddress /me/profile/addresses
Create addresses
New-MgBetaUserProfileAnniversary /me/profile/anniversaries
Create personAnniversary
New-MgBetaUserProfileAward /me/profile/awards
Create awards
New-MgBetaUserProfileCertification /me/profile/certifications
Create certifications
New-MgBetaUserProfileEducationalActivity /me/profile/educationalActivities
Create educationalActivity
New-MgBetaUserProfileEmail /me/profile/emails
Create itemEmail
New-MgBetaUserProfileInterest /me/profile/interests
Create personInterest
New-MgBetaUserProfileLanguage /me/profile/languages
Create languageProficiency
New-MgBetaUserProfileName /me/profile/names
Create personName
New-MgBetaUserProfileNote /me/profile/notes
Create notes
New-MgBetaUserProfilePatent /me/profile/patents
Create patents
New-MgBetaUserProfilePhone /me/profile/phones
Create itemPhone
New-MgBetaUserProfilePosition /me/profile/positions
Create workPosition
New-MgBetaUserProfileProject /me/profile/projects
Create projectParticipation
New-MgBetaUserProfilePublication /me/profile/publications
Create publications
New-MgBetaUserProfileSkill /me/profile/skills
Create skillProficiency
New-MgBetaUserProfileWebAccount /me/profile/webAccounts
Create webAccount
New-MgBetaUserProfileWebsite /me/profile/websites
Create personWebsite
Remove-MgBetaUserManagerByRef /users/{id}/manager/$ref
Remove manager
Remove-MgBetaUserProfile /me/profile
Delete profile
Remove-MgBetaUserProfileAccount /me/profile/account/{id}
Delete userAccountInformation
Remove-MgBetaUserProfileAddress /me/profile/addresses/{id}
Delete itemAddress
Remove-MgBetaUserProfileAnniversary /me/profile/anniversaries/{id}
Delete personAnniversary
Remove-MgBetaUserProfileAward /me/profile/awards/{id}
Delete personAward
Remove-MgBetaUserProfileCertification /me/profile/certifications/{id}
Delete personCertification
Remove-MgBetaUserProfileEducationalActivity /me/profile/educationalActivities/{id}
Delete educationalActivity
Remove-MgBetaUserProfileEmail /me/profile/emails/{id}
Delete itemEmail
Remove-MgBetaUserProfileInterest /me/profile/interests/{id}
Delete personInterest
Remove-MgBetaUserProfileLanguage /me/profile/languages/{id}
Delete languageProficiency
Remove-MgBetaUserProfileName /me/profile/names/{id}
Delete personName
Remove-MgBetaUserProfileNote /me/profile/notes/{id}
Delete personAnnotation
Remove-MgBetaUserProfilePatent /me/profile/patents/{id}
Delete itemPatent
Remove-MgBetaUserProfilePhone /me/profile/phones/{itemPhoneId}
Delete itemPhone
Remove-MgBetaUserProfilePosition /me/profile/positions/{id}
Delete workPosition
Remove-MgBetaUserProfileProject /me/profile/projects/{id}
Delete projectParticipation
Remove-MgBetaUserProfilePublication /me/profile/publications/{id}
Delete itemPublication
Remove-MgBetaUserProfileSkill /me/profile/skills/{id}
Delete skillProficiency
Remove-MgBetaUserProfileWebAccount /me/profile/webAccounts/{id}
Delete webAccount
Remove-MgBetaUserProfileWebsite /me/profile/websites/{id}
Delete personWebsite
Set-MgBetaUserLicense /users/{id | userPrincipalName}/assignLicense
user: assignLicense
Set-MgBetaUserManagerByRef /users/{id}/manager/$ref
Assign a manager
Update-MgBetaAdminPeopleItemInsight /organization/{organizationId}/settings/contactInsights
Update insights
Update-MgBetaOrganizationSettingContactInsight /organization/{organizationId}/settings/contactInsights
Update insights
Update-MgBetaOrganizationSettingPersonInsight /organization/{organizationId}/settings/contactInsights
Update insights
Update-MgBetaUserProfileAccount /me/profile/account/{id}
Update userAccountInformation
Update-MgBetaUserProfileAddress /me/profile/addresses/{id}
Update itemAddress
Update-MgBetaUserProfileAnniversary /me/profile/anniversaries/{id}
Update personAnniversary
Update-MgBetaUserProfileAward /me/profile/awards/{id}
Update personAward
Update-MgBetaUserProfileCertification /me/profile/certifications/{id}
Update personCertification
Update-MgBetaUserProfileEducationalActivity /me/profile/educationalActivities/{id}
Update educationalactivity
Update-MgBetaUserProfileEmail /me/profile/emails/{id}
Update itememail
Update-MgBetaUserProfileInterest /me/profile/interests/{id}
Update personInterest
Update-MgBetaUserProfileLanguage /me/profile/languages/{id}
Update languageProficiency
Update-MgBetaUserProfileName /me/profile/names/{id}
Update personName
Update-MgBetaUserProfileNote /me/profile/notes/{id}
Update personAnnotation
Update-MgBetaUserProfilePatent /me/profile/patents/{id}
Update itemPatent
Update-MgBetaUserProfilePhone /me/profile/phones/{id}
Update itemphone
Update-MgBetaUserProfilePosition /me/profile/positions/{id}
Update workPosition
Update-MgBetaUserProfileProject /me/profile/projects/{id}
Update projectParticipation resource type
Update-MgBetaUserProfilePublication /me/profile/publications/{id}
Update itemPublication
Update-MgBetaUserProfileSkill /me/profile/skills/{id}
Update skillProficiency
Update-MgBetaUserProfileWebAccount /me/profile/webAccounts/{id}
Update webAccount
Update-MgBetaUserProfileWebsite /me/profile/websites/{id}
Update personWebsite

Code Examples

C# / .NET SDK
Add sponsor
View official example on Microsoft Learn
// Code snippets are only available for the latest version. Current version is 5.x

// Dependencies
using Microsoft.Graph.Models;

var requestBody = new ReferenceCreate
{
	OdataId = "https://graph.microsoft.com/v1.0/users/{user-id}",
};

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.Users["{user-id}"].Sponsors.Ref.PostAsync(requestBody);
JavaScript
Add sponsor
View official example on Microsoft Learn
const options = {
	authProvider,
};

const client = Client.init(options);

const directoryObject = {
  '@odata.id': 'https://graph.microsoft.com/v1.0/users/{user-id}'
};

await client.api('/users/d8ab5060-f636-4cff-ae97-d4687f5c83f3/sponsors/$ref')
	.post(directoryObject);
PowerShell
Assign manager
View official example on Microsoft Learn
Import-Module Microsoft.Graph.Users

$params = @{
	"@odata.id" = "https://graph.microsoft.com/v1.0/users/6ea91a8d-e32e-41a1-b7bd-d2d185eed0e0"
}

Set-MgUserManagerByRef -UserId $userId -BodyParameter $params
Python
Add sponsor
View official example on Microsoft Learn
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.reference_create import ReferenceCreate
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ReferenceCreate(
	odata_id = "https://graph.microsoft.com/v1.0/users/{user-id}",
)

await graph_client.users.by_user_id('user-id').sponsors.ref.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 AgentIdUser.ReadWrite.IdentityParentedBy

4

Grant Admin Consent

Application permissions always require admin consent.