Microsoft Entra ID (formerly Azure AD)

Microsoft Entra ID (formerly Azure AD) Admin.people Admin Settings API

The admin.peopleAdminSettings API from Microsoft Entra ID (formerly Azure AD) — 13 operation(s) for admin.peopleadminsettings.

GitHub OpenAPI

Operations 27

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /admin/people Get the organization's people admin settings · Get peopleAdminSettings #
Ask an LLM
“Where can I see all the people settings an admin has configured for our organization?”
“What does the peopleAdminSettings object hold for profile cards, pronouns and insights?”
Tell an agent
Get our organization's people admin settings.
Show the peopleAdminSettings object with its relationships.
GET /admin/people/itemInsights Get the organization's item insights privacy settings · List itemInsights #
Ask an LLM
“Are item insights turned on for our organization right now?”
“Which group, if any, has item insights disabled in our tenant?”
Tell an agent
Show the item insights privacy settings for the organization.
Check whether item insights are enabled across our tenant.
PATCH /admin/people/itemInsights Change who can see item insights in the organization · Update insightsSettings #
Ask an LLM
“How do I turn off item insights for the entire organization?”
“Can I disable item insights for just one Microsoft Entra group?”
Tell an agent
Set item insights enabled for the organization to {enabled}.
Disable item insights for members of group {group}.
DELETE /admin/people/itemInsights Remove the organization's item insights settings · Delete navigation property itemInsights for admin #
Ask an LLM
“Can I delete the item insights settings object for the whole organization?”
“What happens if I clear out the tenant's configured item insights settings?”
Tell an agent destructive · confirm first
Delete the organization's item insights settings.
Remove the itemInsights settings only if its ETag is {etag}.
GET /admin/people/profileCardProperties List custom profile card properties · List profileCardProperties #
Ask an LLM
“Which extra attributes have we added to people's profile cards?”
“What profile card properties are configured for our organization?”
Tell an agent
List all profile card properties configured for the organization.
Show every directory attribute we surface on profile cards.
POST /admin/people/profileCardProperties Add a property to the organization's profile card · Create profileCardProperty #
Ask an LLM
“How do I show an extra directory attribute on everyone's profile card?”
“Can I give a new profile card field a localized display label?”
Tell an agent
Add directory attribute {attribute} to the profile card.
Add {attribute} to profile cards with the display annotations {annotations}.
GET /admin/people/profileCardProperties/{profileCardProperty-id} Get one profile card property · Get profileCardProperty #
Ask an LLM
“How is a specific attribute configured on our profile cards?”
“Can I look up one profile card property by its directory property name?”
Tell an agent
Get profile card property {property}.
Show the labels and visibility set for profile card field {property}.
PATCH /admin/people/profileCardProperties/{profileCardProperty-id} Update a profile card property · Update profileCardProperty #
Ask an LLM
“Can I hide an existing profile card field without deleting it?”
“How do I change the display label of a profile card attribute we already added?”
Tell an agent
Set visibility of profile card property {property} to {visible}.
Replace the annotations on existing profile card property {property} with {annotations}.
DELETE /admin/people/profileCardProperties/{profileCardProperty-id} Remove a property from the profile card · Delete profileCardProperty #
Ask an LLM
“How do I take a custom attribute off everyone's profile card?”
“Does removing a profile card property also drop its localized labels?”
Tell an agent destructive · confirm first
Remove profile card property {property}.
Delete {property} from the profile card along with its localized customizations.
GET /admin/people/profileCardProperties/$count Count profile card properties · Get the number of the resource #
Ask an LLM
“How many custom properties are on our profile cards?”
“What's the total number of profile card properties defined?”
Tell an agent
Count the profile card properties in the organization.
Tell me how many attributes we've added to the profile card.
GET /admin/people/profilePropertySettings List profile property settings · List profilePropertySettings #
Ask an LLM
“Which user profile property settings are configured in our organization?”
“What source priority is set for each user profile property?”
Tell an agent
List all profile property settings.
Show how each user profile property is configured, including prioritized sources.
POST /admin/people/profilePropertySettings Create a profile property setting · Create profilePropertySetting #
Ask an LLM
“How do I define which sources take priority for a user profile property?”
“Can I add a new profile property setting with a display name?”
Tell an agent
Create a profile property setting named {name}.
Create profile property setting {name} with prioritized sources {sources}.
GET /admin/people/profilePropertySettings/{profilePropertySetting-id} Get one profile property setting · Get profilePropertySetting #
Ask an LLM
“How is one specific profile property setting configured?”
“Can I read a single profile property setting by its ID?”
Tell an agent
Get profile property setting {setting}.
Show the source priority order for profile property setting {setting}.
PATCH /admin/people/profilePropertySettings/{profilePropertySetting-id} Update a profile property setting · Update profilePropertySetting #
Ask an LLM
“How do I reorder the prioritized sources on an existing profile property setting?”
“Can I rename a profile property setting's display name?”
Tell an agent
Set the prioritized sources of profile property setting {setting} to {sources}.
Change the display name of profile property setting {setting} to {displayName}.
DELETE /admin/people/profilePropertySettings/{profilePropertySetting-id} Delete a profile property setting · Delete profilePropertySetting #
Ask an LLM
“How do I remove a profile property setting we no longer need?”
“Can I delete a profile property setting only if it hasn't changed since I read it?”
Tell an agent destructive · confirm first
Delete profile property setting {setting}.
Delete profile property setting {setting} if its ETag still matches {etag}.
GET /admin/people/profilePropertySettings/$count Count profile property settings · Get the number of the resource #
Ask an LLM
“How many profile property settings exist in our tenant?”
“What's the number of configured profile property settings?”
Tell an agent
Count the profile property settings.
Tell me how many profile property settings the organization has.
GET /admin/people/profileSources List profile data sources · List profileSources #
Ask an LLM
“Which external and built-in data sources feed our user profiles?”
“What profile sources are connected to our organization?”
Tell an agent
List all profile sources for the organization.
Show every external and Microsoft data source configured for profiles.
POST /admin/people/profileSources Add a profile data source · Create profileSource #
Ask an LLM
“How do I connect a new external data source for user profiles?”
“Can I register a profile source with its own web URL and localized names?”
Tell an agent
Create a profile source named {displayName} with source ID {sourceId}.
Add profile source {sourceId} of kind {kind} linking to {webUrl}.
GET /admin/people/profileSources/{profileSource-id} Get a profile source by its object ID · Get profileSources from admin #
Ask an LLM
“How is one profile data source set up, looked up by its object ID?”
“Can I read a single profile source's display name and web URL by ID?”
Tell an agent
Get profile source {source} by its object ID.
Show the configuration of profile source object {source}.
PATCH /admin/people/profileSources/{profileSource-id} Update a profile source by its object ID · Update profileSource #
Ask an LLM
“How do I rename a profile source when I have its object ID?”
“Can I change the web URL of an existing profile source by object ID?”
Tell an agent
Rename profile source object {source} to {displayName}.
Set the web URL of profile source object {source} to {webUrl}.
DELETE /admin/people/profileSources/{profileSource-id} Delete a profile source by its object ID · Delete profileSource #
Ask an LLM
“How do I disconnect a profile data source using its object ID?”
“Can I remove a profile source by object ID only if its ETag matches?”
Tell an agent destructive · confirm first
Delete profile source object {source}.
Delete profile source object {source} if its ETag is {etag}.
GET /admin/people/profileSources(sourceId='{sourceId}') Get a profile source by its source ID · Get profileSources from admin #
Ask an LLM
“Can I look up a profile source using its sourceId instead of the object ID?”
“How is the profile source with a given source identifier configured?”
Tell an agent
Get the profile source whose sourceId is {sourceId}.
Show the settings of profile source with source identifier {sourceId}.
PATCH /admin/people/profileSources(sourceId='{sourceId}') Update a profile source by its source ID · Update profileSource #
Ask an LLM
“How do I update a profile source addressed by its sourceId?”
“Can I change localized names on a profile source using its source identifier?”
Tell an agent
Rename the profile source with sourceId {sourceId} to {displayName}.
Set localizations {localizations} on profile source with source identifier {sourceId}.
DELETE /admin/people/profileSources(sourceId='{sourceId}') Delete a profile source by its source ID · Delete profileSource #
Ask an LLM
“How do I remove a profile source when I only know its sourceId?”
“Can I delete a profile source addressed by source identifier rather than object ID?”
Tell an agent destructive · confirm first
Delete the profile source with sourceId {sourceId}.
Remove profile source by source identifier {sourceId} if its ETag matches {etag}.
GET /admin/people/profileSources/$count Count profile sources · Get the number of the resource #
Ask an LLM
“How many profile data sources are configured?”
“What's the total count of profile sources in our organization?”
Tell an agent
Count the profile sources.
Tell me how many data sources feed user profiles.
GET /admin/people/pronouns Get the organization's pronouns settings · List pronounsSettings #
Ask an LLM
“Is pronouns display turned on for our organization?”
“Where do I check the tenant-wide pronouns setting?”
Tell an agent
Show the organization's pronouns settings.
Check whether pronouns are enabled in our tenant.
PATCH /admin/people/pronouns Turn pronouns on or off for the organization · Update pronounsSettings #
Ask an LLM
“How do I enable pronouns on profiles across our organization?”
“Can I switch off pronouns support for the whole tenant?”
Tell an agent
Set pronouns enabled for the organization to {enabled}.
Turn on pronouns support organization-wide.

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/graph/api/overview
📖
Authentication
https://learn.microsoft.com/en-us/graph/auth/
📖
Documentation
https://learn.microsoft.com/en-us/graph/change-notifications-overview

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/openapi/azure-ad-admin-peopleadminsettings-api-openapi.yml

Other Resources

🔗
SDKs
https://learn.microsoft.com/en-us/graph/sdks/sdks-overview
🔗
ChangeLog
https://developer.microsoft.com/en-us/graph/changelog
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/asyncapi/azure-ad-change-notifications-webhooks.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/azure-ad:azure-ad-admin-peopleadminsettings-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

azure-ad-admin-peopleadminsettings-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Identity.DirectoryManagement Admin.people Admin Settings API
  version: v1.0
servers:
- url: https://graph.microsoft.com/v1.0/
  description: Core
security:
- azureaadv2: []
tags:


# --- truncated at 32 KB (44 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/openapi/azure-ad-admin-peopleadminsettings-api-openapi.yml