Microsoft Entra ID (formerly Azure AD) · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Groups Group Setting Templates.group Setting…

9 actions 9 updates phrasing extends openapi/azure-ad-groupsettingtemplates-groupsettingtemplate-actions-api-openapi.yml
Generated by API Evangelist Written by API Evangelist tooling for Microsoft Entra ID (formerly Azure AD)'s API. It is a proposal applied on top of the contract, not a document Microsoft Entra ID (formerly Azure AD) publishes.
View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 9

$.info
$.paths['/groupSettingTemplates/{groupSettingTemplate-id}/microsoft.graph.checkMemberGroups'].post
$.paths['/groupSettingTemplates/{groupSettingTemplate-id}/microsoft.graph.checkMemberObjects'].post
$.paths['/groupSettingTemplates/{groupSettingTemplate-id}/microsoft.graph.getMemberGroups'].post
$.paths['/groupSettingTemplates/{groupSettingTemplate-id}/microsoft.graph.getMemberObjects'].post
$.paths['/groupSettingTemplates/{groupSettingTemplate-id}/microsoft.graph.restore'].post
$.paths['/groupSettingTemplates/microsoft.graph.getAvailableExtensionProperties'].post
$.paths['/groupSettingTemplates/microsoft.graph.getByIds'].post
$.paths['/groupSettingTemplates/microsoft.graph.validateProperties'].post

OpenAPI Overlay

Raw ↑
# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Groups Group Setting Templates.group Setting…
  version: 1.0.0
extends: openapi/azure-ad-groupsettingtemplates-groupsettingtemplate-actions-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 8
- target: $.paths['/groupSettingTemplates/{groupSettingTemplate-id}/microsoft.graph.checkMemberGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Check group membership of a setting template
      effect: read
      questions:
      - Which of these group IDs is a group setting template object a member of?
      - Can I check a group setting template against a list of groups in one call?
      instructions:
      - text: Check which of groups {groupIds} group setting template {template} belongs to.
        slots:
          groupIds: requestBody.groupIds
          template: path.groupSettingTemplate-id
      - text: Run checkMemberGroups for group setting template {template}.
        slots:
          template: path.groupSettingTemplate-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groupSettingTemplates/{groupSettingTemplate-id}/microsoft.graph.checkMemberObjects'].post
  update:
    x-apievangelist-phrasing:
      intent: Check object membership of a setting template
      effect: read
      questions:
      - Is a group setting template a member of any of these groups, administrative units or roles?
      - What does checkMemberObjects return for a group setting template?
      instructions:
      - text: Check which of objects {ids} group setting template {template} is a member of.
        slots:
          ids: requestBody.ids
          template: path.groupSettingTemplate-id
      - text: Run checkMemberObjects on group setting template {template}.
        slots:
          template: path.groupSettingTemplate-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groupSettingTemplates/{groupSettingTemplate-id}/microsoft.graph.getMemberGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Get groups a setting template belongs to
      effect: read
      questions:
      - Which groups is a given group setting template object a member of?
      - Can I restrict the member groups returned to security-enabled groups only?
      instructions:
      - text: List the group IDs that group setting template {template} is a member of.
        slots:
          template: path.groupSettingTemplate-id
      - text: Get only security-enabled member groups for template {template}.
        slots:
          template: path.groupSettingTemplate-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groupSettingTemplates/{groupSettingTemplate-id}/microsoft.graph.getMemberObjects'].post
  update:
    x-apievangelist-phrasing:
      intent: Get all memberships of a setting template
      effect: read
      questions:
      - What groups, administrative units and directory roles is a group setting template a member of?
      - Is there a call that returns every membership object ID for a group setting template?
      instructions:
      - text: Get all member object IDs for group setting template {template}.
        slots:
          template: path.groupSettingTemplate-id
      - text: List groups, admin units and roles that template {template} belongs to, security-enabled only when {securityEnabledOnly}.
        slots:
          template: path.groupSettingTemplate-id
          securityEnabledOnly: requestBody.securityEnabledOnly
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groupSettingTemplates/{groupSettingTemplate-id}/microsoft.graph.restore'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a deleted group setting template
      effect: write
      questions:
      - Can I restore a recently deleted directory object through the group setting templates path?
      - How do I bring back a group setting template from deleted items?
      instructions:
      - text: Restore deleted group setting template {template}.
        slots:
          template: path.groupSettingTemplate-id
      - text: Recover directory object {template} from deleted items.
        slots:
          template: path.groupSettingTemplate-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groupSettingTemplates/microsoft.graph.getAvailableExtensionProperties'].post
  update:
    x-apievangelist-phrasing:
      intent: List available directory extension properties
      effect: read
      questions:
      - Which directory extension properties are registered in my tenant, including from multitenant apps?
      - Can I see only the extension properties that are synced from on-premises?
      instructions:
      - text: List all directory extension definitions registered in the directory.
      - text: 'Get available extension properties, synced from on-premises only: {isSyncedFromOnPremises}.'
        slots:
          isSyncedFromOnPremises: requestBody.isSyncedFromOnPremises
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groupSettingTemplates/microsoft.graph.getByIds'].post
  update:
    x-apievangelist-phrasing:
      intent: Get directory objects by a list of IDs
      effect: read
      questions:
      - How do I fetch several directory objects at once when I have their IDs?
      - Can I limit a bulk lookup by IDs to certain object types like users or groups?
      instructions:
      - text: Get the directory objects with IDs {ids}.
        slots:
          ids: requestBody.ids
      - text: Look up objects {ids} restricted to types {types}.
        slots:
          ids: requestBody.ids
          types: requestBody.types
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groupSettingTemplates/microsoft.graph.validateProperties'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate a group name against naming policy
      effect: read
      questions:
      - Will this Microsoft 365 group display name comply with our naming policy before I create it?
      - Can I check a mail nickname for blocked words ahead of creating a group?
      instructions:
      - text: Check whether display name {displayName} complies with the group naming policy.
        slots:
          displayName: requestBody.displayName
      - text: Validate mail nickname {mailNickname} for a group before creating it.
        slots:
          mailNickname: requestBody.mailNickname
      method: generated
      generated: '2026-10-01'