API Evangelist conversational phrasing for Groups.directory Object API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Groups.directory Object API
  version: 1.0.0
extends: openapi/azure-ad-groups-directoryobject-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: 121
- target: $.paths['/groups/{group-id}/acceptedSenders'].get
  update:
    x-apievangelist-phrasing:
      intent: List who may post to a group's conversations
      effect: read
      questions:
      - Who is on the accepted senders list allowed to post in a group's conversations?
      - Can I see the full user and group objects on a group's allowed-senders list, not just their ids?
      instructions:
      - text: Show the accepted senders for group {group}.
        slots:
          group: path.group-id
      - text: List everyone allowed to post to conversations in group {group}, with their details.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/acceptedSenders/{directoryObject-id}/$ref'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove one accepted sender from a group
      effect: destructive
      questions:
      - How do I take a specific user off a group's accepted senders list by their object id?
      - Can I revoke one person's permission to post to a group's conversations?
      instructions:
      - text: Remove {object} from the accepted senders of group {group}.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      - text: Stop directory object {object} from being an allowed sender in group {group}.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/acceptedSenders/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a group's accepted senders
      effect: read
      questions:
      - How many users and groups are on a group's accepted senders list?
      - Is there a quick way to get just the number of allowed senders for a group?
      instructions:
      - text: Count the accepted senders on group {group}.
        slots:
          group: path.group-id
      - text: Tell me how many senders are allowed to post in group {group}.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/acceptedSenders/$ref'].get
  update:
    x-apievangelist-phrasing:
      intent: List accepted sender references for a group
      effect: read
      questions:
      - Can I get only the reference links of a group's accepted senders instead of full objects?
      - What ids are on a group's accepted senders list?
      instructions:
      - text: List the accepted sender references for group {group}.
        slots:
          group: path.group-id
      - text: Give me just the @odata.id links of the allowed senders in group {group}.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/acceptedSenders/$ref'].post
  update:
    x-apievangelist-phrasing:
      intent: Allow a user or group to post to a group
      effect: write
      questions:
      - How do I add a user to a group's accepted senders so they can post to its conversations?
      - What happens if I add someone to accepted senders who is already on the rejected senders list?
      instructions:
      - text: Add {ref} to the accepted senders of group {group}.
        slots:
          ref: requestBody.@odata.id
          group: path.group-id
      - text: Let the user at {ref} post to conversations in group {group}.
        slots:
          ref: requestBody.@odata.id
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/acceptedSenders/$ref'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an accepted sender by reference link
      effect: destructive
      questions:
      - Can I remove an accepted sender from a group by passing its @id reference in the query?
      - Is there a way to drop an allowed sender using its full directory reference URL?
      instructions:
      - text: Remove the accepted sender with reference {ref_id} from group {group}.
        slots:
          ref_id: query.@id
          group: path.group-id
      - text: Delete the allowed-sender entry {ref_id} on group {group} using its @id.
        slots:
          ref_id: query.@id
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/createdOnBehalfOf'].get
  update:
    x-apievangelist-phrasing:
      intent: See who a group was created on behalf of
      effect: read
      questions:
      - Which user or application created a group on someone's behalf?
      - Why is the created-on-behalf-of value empty for a group an administrator made?
      instructions:
      - text: Show who group {group} was created on behalf of.
        slots:
          group: path.group-id
      - text: Find the user or app that created group {group}.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/memberOf'].get
  update:
    x-apievangelist-phrasing:
      intent: List groups and units a group directly belongs to
      effect: read
      questions:
      - Which groups, administrative units and admin roles is a group a direct member of?
      - Does the memberOf list for a group include nested parent groups?
      instructions:
      - text: List what group {group} is directly a member of.
        slots:
          group: path.group-id
      - text: Show the direct parent groups, admin units and roles of group {group}.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/memberOf/{directoryObject-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one parent a group directly belongs to
      effect: read
      questions:
      - Can I fetch one specific parent group or role that a group directly belongs to?
      - How do I read a single entry from a group's direct memberOf list?
      instructions:
      - text: Get parent object {object} from the direct memberOf list of group {group}.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      - text: Show details of {object}, which group {group} is a direct member of.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/memberOf/{directoryObject-id}/microsoft.graph.administrativeUnit'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a group's direct parent as an admin unit
      effect: read
      questions:
      - Can I read one entry in a group's direct memberships cast as an administrative unit?
      - How do I get the administrative unit details of a unit a group directly belongs to?
      instructions:
      - text: Get administrative unit {object} that group {group} directly belongs to.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      - text: Show direct membership {object} of group {group} as an administrative unit.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/memberOf/{directoryObject-id}/microsoft.graph.group'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a group's direct parent as a group
      effect: read
      questions:
      - Can I read one of a group's direct parent entries with full group properties?
      - What does a parent group look like when fetched from a group's direct memberOf as a group type?
      instructions:
      - text: Get parent group {object} that group {group} is directly nested in.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      - text: Show direct membership {object} of group {group} cast as a group.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/memberOf/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count what a group directly belongs to
      effect: read
      questions:
      - How many groups, units and roles is a group directly a member of?
      - Is there a count endpoint for a group's direct memberOf list?
      instructions:
      - text: Count the direct memberships of group {group}.
        slots:
          group: path.group-id
      - text: Tell me how many things group {group} directly belongs to.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/memberOf/microsoft.graph.administrativeUnit'].get
  update:
    x-apievangelist-phrasing:
      intent: List admin units a group directly belongs to
      effect: read
      questions:
      - Which administrative units is a group directly a member of?
      - Can I filter a group's direct memberships down to administrative units only?
      instructions:
      - text: List the administrative units group {group} directly belongs to.
        slots:
          group: path.group-id
      - text: Show only admin units in the direct memberOf of group {group}.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/memberOf/microsoft.graph.administrativeUnit/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count admin units a group directly belongs to
      effect: read
      questions:
      - How many administrative units is a group directly part of?
      - Can I count just the admin units in a group's direct memberships?
      instructions:
      - text: Count the administrative units group {group} directly belongs to.
        slots:
          group: path.group-id
      - text: Tell me the number of admin units that directly contain group {group}.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/memberOf/microsoft.graph.group'].get
  update:
    x-apievangelist-phrasing:
      intent: List groups a group is directly nested in
      effect: read
      questions:
      - Which parent groups is a group directly nested inside?
      - Can I list a group's direct memberships restricted to groups only, skipping roles and admin units?
      instructions:
      - text: List the parent groups that directly contain group {group}.
        slots:
          group: path.group-id
      - text: Show only groups in the direct memberOf of group {group}.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/memberOf/microsoft.graph.group/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count groups a group is directly nested in
      effect: read
      questions:
      - How many parent groups directly contain a given group?
      - Can I count only groups in a group's direct memberOf?
      instructions:
      - text: Count the parent groups that directly contain group {group}.
        slots:
          group: path.group-id
      - text: Tell me how many groups group {group} is directly nested in.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members'].get
  update:
    x-apievangelist-phrasing:
      intent: List a group's direct members
      effect: read
      questions:
      - Who are the direct members of a group, including users, devices and contacts?
      - Does listing a group's members include people in nested subgroups?
      - Can I page through a group's direct members with $top and $skip?
      instructions:
      - text: List the direct members of group {group}.
        slots:
          group: path.group-id
      - text: Show the first {top} direct members of group {group}.
        slots:
          top: query.$top
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/{directoryObject-id}/$ref'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a member from a group
      effect: destructive
      questions:
      - How do I remove someone from a group by their object id?
      - Can I remove members from a group that uses dynamic membership?
      instructions:
      - text: Remove member {object} from group {group}.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      - text: Take directory object {object} out of the members of group {group}.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/{directoryObject-id}/microsoft.graph.application'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a group member as an application
      effect: read
      questions:
      - Can I read an app that is a direct member of a group with its application properties?
      - How do I fetch one group member cast as an application?
      instructions:
      - text: Get application member {object} of group {group}.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      - text: Show direct member {object} of group {group} as an application.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/{directoryObject-id}/microsoft.graph.device'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a group member as a device
      effect: read
      questions:
      - Can I read a device that is a direct member of a group with its device details?
      - How do I fetch one direct group member cast as a device?
      instructions:
      - text: Get device member {object} of group {group}.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      - text: Show direct member {object} of group {group} as a device.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/{directoryObject-id}/microsoft.graph.group'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a nested subgroup member of a group
      effect: read
      questions:
      - Can I read a subgroup that sits directly inside a group, with its group properties?
      - How do I fetch one direct member of a group cast as a group?
      instructions:
      - text: Get subgroup member {object} of group {group}.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      - text: Look up the nested group {object} sitting directly in group {group}.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/{directoryObject-id}/microsoft.graph.orgContact'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a group member as an organizational contact
      effect: read
      questions:
      - Can I read an organizational contact that is a direct member of a group?
      - How do I fetch one direct group member cast as an org contact?
      instructions:
      - text: Get organizational contact member {object} of group {group}.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      - text: Show direct member {object} of group {group} as an org contact.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/{directoryObject-id}/microsoft.graph.servicePrincipal'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a group member as a service principal
      effect: read
      questions:
      - Can I read a service principal that is a direct member of a group?
      - How do I fetch one direct group member cast as a service principal?
      instructions:
      - text: Get service principal member {object} of group {group}.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      - text: Show direct member {object} of group {group} as a service principal.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/{directoryObject-id}/microsoft.graph.user'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a group member as a user
      effect: read
      questions:
      - Can I read a user who is a direct member of a group with their user profile fields?
      - How do I fetch one direct group member cast as a user?
      instructions:
      - text: Get user member {object} of group {group}.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      - text: Show the user profile of direct member {object} in group {group}.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a group's direct members
      effect: read
      questions:
      - How many direct members does a group have?
      - Can I count a group's direct members matching a filter?
      instructions:
      - text: Count the direct members of group {group}.
        slots:
          group: path.group-id
      - text: Tell me how many members are directly in group {group}.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/$ref'].get
  update:
    x-apievangelist-phrasing:
      intent: List member references for a group
      effect: read
      questions:
      - Can I get just the reference ids of a group's direct members without their full objects?
      - What @odata.id links make up a group's member list?
      instructions:
      - text: List the member references of group {group}.
        slots:
          group: path.group-id
      - text: Give me only the ids of the direct members in group {group}.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/$ref'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a member to a group
      effect: write
      questions:
      - How do I add a user to a security or Microsoft 365 group?
      - What is the limit on how many members I can add to a group in one request?
      instructions:
      - text: Add {ref} as a member of group {group}.
        slots:
          ref: requestBody.@odata.id
          group: path.group-id
      - text: Put the directory object at {ref} into group {group}.
        slots:
          ref: requestBody.@odata.id
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/$ref'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a group member by reference link
      effect: destructive
      questions:
      - Can I remove a group member by passing its @id reference in the query string?
      - Is there a way to remove someone from a group using the full directory reference URL?
      instructions:
      - text: Remove the member with reference {ref_id} from group {group}.
        slots:
          ref_id: query.@id
          group: path.group-id
      - text: Delete membership {ref_id} from group {group} using its @id.
        slots:
          ref_id: query.@id
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/microsoft.graph.application'].get
  update:
    x-apievangelist-phrasing:
      intent: List applications that are group members
      effect: read
      questions:
      - Which applications are direct members of a group?
      - Can I filter a group's direct members to apps only?
      instructions:
      - text: List the application members of group {group}.
        slots:
          group: path.group-id
      - text: Show only apps among the direct members of group {group}.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/microsoft.graph.application/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count applications that are group members
      effect: read
      questions:
      - How many applications are direct members of a group?
      - Can I count only the app members of a group?
      instructions:
      - text: Count the application members of group {group}.
        slots:
          group: path.group-id
      - text: Tell me how many apps are directly in group {group}.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/microsoft.graph.device'].get
  update:
    x-apievangelist-phrasing:
      intent: List devices that are group members
      effect: read
      questions:
      - Which devices are direct members of a group?
      - Can I list a group's direct members restricted to devices?
      instructions:
      - text: List the device members of group {group}.
        slots:
          group: path.group-id
      - text: Show only devices among the direct members of group {group}.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/microsoft.graph.device/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count devices that are group members
      effect: read
      questions:
      - How many devices are direct members of a group?
      - Can I count only the device members of a group?
      instructions:
      - text: Count the device members of group {group}.
        slots:
          group: path.group-id
      - text: Tell me how many devices are directly in group {group}.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/microsoft.graph.group'].get
  update:
    x-apievangelist-phrasing:
      intent: List subgroups directly inside a group
      effect: read
      questions:
      - Which groups are nested directly inside a group?
      - Can I list a group's direct members limited to subgroups?
      instructions:
      - text: List the subgroups directly inside group {group}.
        slots:
          group: path.group-id
      - text: Show only groups among the direct members of group {group}.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/microsoft.graph.group/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count subgroups directly inside a group
      effect: read
      questions:
      - How many subgroups are nested directly in a group?
      - Can I count only the group-type direct members of a group?
      instructions:
      - text: Count the subgroups directly inside group {group}.
        slots:
          group: path.group-id
      - text: Tell me how many groups are direct members of group {group}.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/microsoft.graph.orgContact'].get
  update:
    x-apievangelist-phrasing:
      intent: List org contacts that are group members
      effect: read
      questions:
      - Which organizational contacts are direct members of a group?
      - Can I list a group's direct members restricted to external contacts?
      instructions:
      - text: List the organizational contact members of group {group}.
        slots:
          group: path.group-id
      - text: Show only org contacts among the direct members of group {group}.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/microsoft.graph.orgContact/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count org contacts that are group members
      effect: read
      questions:
      - How many organizational contacts are direct members of a group?
      - Can I count only the org contact members of a group?
      instructions:
      - text: Count the organizational contact members of group {group}.
        slots:
          group: path.group-id
      - text: Tell me how many org contacts are directly in group {group}.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/microsoft.graph.servicePrincipal'].get
  update:
    x-apievangelist-phrasing:
      intent: List service principals that are group members
      effect: read
      questions:
      - Which service principals are direct members of a group?
      - Can I list a group's direct members limited to service principals?
      instructions:
      - text: List the service principal members of group {group}.
        slots:
          group: path.group-id
      - text: Show only service principals among the direct members of group {group}.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/microsoft.graph.servicePrincipal/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count service principals that are group members
      effect: read
      questions:
      - How many service principals are direct members of a group?
      - Can I count only the service principal members of a group?
      instructions:
      - text: Count the service principal members of group {group}.
        slots:
          group: path.group-id
      - text: Tell me how many service principals are directly in group {group}.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/microsoft.graph.user'].get
  update:
    x-apievangelist-phrasing:
      intent: List users who are direct group members
      effect: read
      questions:
      - Which users are direct members of a group, leaving out devices and apps?
      - Can I search a group's direct user members by display name?
      instructions:
      - text: List the user members of group {group}.
        slots:
          group: path.group-id
      - text: Show only people among the direct members of group {group}.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/members/microsoft.graph.user/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count users who are direct group members
      effect: read
      questions:
      - How many users are direct members of a group?
      - Can I count only the people who are directly in a group?
      instructions:
      - text: Count the user members of group {group}.
        slots:
          group: path.group-id
      - text: Tell me how many users are directly in group {group}.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/membersWithLicenseErrors'].get
  update:
    x-apievangelist-phrasing:
      intent: List group members with license assignment errors
      effect: read
      questions:
      - Which members of a group failed to get their group-based license assigned?
      - Can I find members whose licenses from a group assignment are in an error state?
      instructions:
      - text: List the members of group {group} that have license errors.
        slots:
          group: path.group-id
      - text: Show who in group {group} failed group-based license assignment.
        slots:
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/membersWithLicenseErrors/{directoryObject-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one group member with a license error
      effect: read
      questions:
      - Can I look up one specific member that has a license error from a group's license assignment?
      - How do I read a single entry from a group's license-error member list?
      instructions:
      - text: Get license-error member {object} of group {group}.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      - text: Show details of {object}, which has a license assignment error in group {group}.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/membersWithLicenseErrors/{directoryObject-id}/microsoft.graph.application'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a license-error member as an application
      effect: read
      questions:
      - Can I read an entry from a group's license-error members cast as an application?
      - How do I get app properties for one member flagged with a license error?
      instructions:
      - text: Get license-error member {object} of group {group} as an application.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      - text: Show app {object} from the license-error members of group {group}.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/membersWithLicenseErrors/{directoryObject-id}/microsoft.graph.device'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a license-error member as a device
      effect: read
      questions:
      - Which device properties come back for a license-error member of a group read as a device?
      - Is there a way to view the hardware details of a device flagged in a group's license errors?
      instructions:
      - text: Get license-error member {object} of group {group} as a device.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      - text: Show device {object} from the license-error members of group {group}.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/membersWithLicenseErrors/{directoryObject-id}/microsoft.graph.group'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a license-error member as a group
      effect: read
      questions:
      - Can I read a subgroup from a group's license-error members with its group properties?
      - How do I fetch one license-error member of a group cast as a group?
      instructions:
      - text: Read subgroup {object} flagged with license errors in group {group}.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      - text: Show subgroup {object} from the license-error members of group {group}.
        slots:
          object: path.directoryObject-id
          group: path.group-id
      method: generated
      generated: '2026-10-01'


# --- truncated at 32 KB (84 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/overlays/azure-ad-groups-directoryobject-api-phrasing-overlay.yaml