API Evangelist conversational phrasing for Identity.DirectoryManagement Organization.organization.Actio…

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Identity.DirectoryManagement Organization.organization.Actio…
  version: 1.0.0
extends: openapi/azure-ad-organization-organization-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: 9
- target: $.paths['/organization/{organization-id}/microsoft.graph.checkMemberGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Check an organization's membership in groups
      effect: read
      questions:
      - Is this directory object a member of any of these specific groups?
      - How many group IDs can I check for membership in a single request?
      instructions:
      - text: Check which of groups {groups} organization {org} is a member of.
        slots:
          groups: requestBody.groupIds
          org: path.organization-id
      - text: For organization {org}, test membership in group IDs {groups}.
        slots:
          org: path.organization-id
          groups: requestBody.groupIds
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/microsoft.graph.checkMemberObjects'].post
  update:
    x-apievangelist-phrasing:
      intent: Check an organization's membership in objects
      effect: read
      questions:
      - Can I check membership against a mixed list of groups, roles and administrative units?
      - Which of a list of directory object IDs does an organization object belong to?
      instructions:
      - text: Check which of objects {ids} organization {org} is a member of.
        slots:
          ids: requestBody.ids
          org: path.organization-id
      - text: Test organization {org} for membership in directory objects {ids}.
        slots:
          org: path.organization-id
          ids: requestBody.ids
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/microsoft.graph.getMemberGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Get all groups an organization belongs to
      effect: read
      questions:
      - What groups does an organization object belong to, including transitive membership?
      - Can I limit the membership lookup to security-enabled groups only?
      - What happens when there are more than 11,000 group memberships?
      instructions:
      - text: Get every group ID organization {org} is a member of.
        slots:
          org: path.organization-id
      - text: 'List group memberships of organization {org}, security groups only: {securityOnly}.'
        slots:
          org: path.organization-id
          securityOnly: requestBody.securityEnabledOnly
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/microsoft.graph.getMemberObjects'].post
  update:
    x-apievangelist-phrasing:
      intent: Get groups, units and roles an org belongs to
      effect: read
      questions:
      - Which groups, administrative units and directory roles is an organization object a member of?
      - Does getMemberObjects include directory roles as well as groups?
      instructions:
      - text: Get all member-of object IDs for organization {org}.
        slots:
          org: path.organization-id
      - text: List groups, admin units and roles containing organization {org}, security-enabled only {securityOnly}.
        slots:
          org: path.organization-id
          securityOnly: requestBody.securityEnabledOnly
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/microsoft.graph.restore'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a deleted directory object
      effect: write
      questions:
      - How do I restore a recently deleted user, group or application from deleted items?
      - Does restoring an application also bring back its service principal?
      instructions:
      - text: Restore deleted directory object {org}.
        slots:
          org: path.organization-id
      - text: Undelete object {org} from deleted items via the organization restore action.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/{organization-id}/microsoft.graph.setMobileDeviceManagementAuthority'].post
  update:
    x-apievangelist-phrasing:
      intent: Set the mobile device management authority
      effect: write
      questions:
      - How do I set the mobile device management authority for my organization?
      - Can I configure MDM authority for a tenant through Microsoft Graph?
      instructions:
      - text: Set the mobile device management authority for organization {org}.
        slots:
          org: path.organization-id
      - text: Configure MDM authority on tenant {org}.
        slots:
          org: path.organization-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/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 list only the extension properties synced from on-premises?
      instructions:
      - text: List all directory extension properties available in the tenant.
      - text: Show extension properties where synced from on-premises is {synced}.
        slots:
          synced: requestBody.isSyncedFromOnPremises
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/microsoft.graph.getByIds'].post
  update:
    x-apievangelist-phrasing:
      intent: Get directory objects by their IDs
      effect: read
      questions:
      - How do I resolve a batch of object IDs to users, groups and devices in one call?
      - Can I restrict an ID lookup to certain object types like user or group?
      instructions:
      - text: Get directory objects for IDs {ids}.
        slots:
          ids: requestBody.ids
      - text: Resolve IDs {ids} limited to types {types}.
        slots:
          ids: requestBody.ids
          types: requestBody.types
      method: generated
      generated: '2026-10-01'
- target: $.paths['/organization/microsoft.graph.validateProperties'].post
  update:
    x-apievangelist-phrasing:
      intent: Validate a Microsoft 365 group name
      effect: read
      questions:
      - Does a proposed Microsoft 365 group name comply with our naming policy and banned words?
      - Can I check a mail nickname is unique before creating a group?
      instructions:
      - text: Validate display name {name} and mail nickname {nickname} for a new group.
        slots:
          name: requestBody.displayName
          nickname: requestBody.mailNickname
      - text: Check {name} against group naming policy on behalf of user {user}.
        slots:
          name: requestBody.displayName
          user: requestBody.onBehalfOfUserId
      method: generated
      generated: '2026-10-01'