# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Users.directory Object API
  version: 1.0.0
extends: openapi/azure-ad-users-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: 88
- target: $.paths['/users/{user-id}/createdObjects'].get
  update:
    x-apievangelist-phrasing:
      intent: List directory objects a user created
      effect: read
      questions:
      - Which directory objects did a particular user create?
      - Can I filter the objects someone created by a property?
      instructions:
      - text: List everything {user} has created in the directory.
        slots:
          user: path.user-id
      - text: Show objects created by {user} matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/createdObjects/{directoryObject-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one object a user created
      effect: read
      questions:
      - How do I look up a single object from a user's created objects?
      - Can I fetch one specific item a user created by its ID?
      instructions:
      - text: Get created object {object} from {user}'s created items.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      - text: Fetch the object {object} that {user} created, returning only {fields}.
        slots:
          object: path.directoryObject-id
          user: path.user-id
          fields: query.$select
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/createdObjects/{directoryObject-id}/microsoft.graph.servicePrincipal'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a user-created object as a service principal
      effect: read
      questions:
      - Can I read an object a user created cast as a service principal?
      - What does a user-created service principal look like when fetched by ID?
      instructions:
      - text: Get {object} from {user}'s created objects as a service principal.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      - text: Cast created object {object} of {user} to a service principal and show it.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/createdObjects/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count the objects a user created
      effect: read
      questions:
      - How many directory objects has a given user created?
      - Is it possible to count only the created objects that match a filter?
      instructions:
      - text: Count the objects {user} has created.
        slots:
          user: path.user-id
      - text: Tell me how many created objects of {user} match {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/createdObjects/microsoft.graph.servicePrincipal'].get
  update:
    x-apievangelist-phrasing:
      intent: List service principals a user created
      effect: read
      questions:
      - Which service principals were created by a specific user?
      - Can I search the service principals a person created by name?
      instructions:
      - text: List the service principals {user} created.
        slots:
          user: path.user-id
      - text: Search service principals created by {user} for {term}.
        slots:
          user: path.user-id
          term: query.$search
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/createdObjects/microsoft.graph.servicePrincipal/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count service principals a user created
      effect: read
      questions:
      - How many service principals has one user created?
      - What's the total of created service principals for a user matching a filter?
      instructions:
      - text: Count service principals created by {user}.
        slots:
          user: path.user-id
      - text: Give the number of service principals {user} created that match {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/directReports'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's direct reports
      effect: read
      questions:
      - Who reports directly to a given user or agent user?
      - Can I list both users and contacts that report to someone?
      instructions:
      - text: List direct reports of {user}.
        slots:
          user: path.user-id
      - text: Show {user}'s direct reports filtered by {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/directReports/{directoryObject-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one direct report of a user
      effect: read
      questions:
      - How do I fetch a single person from someone's direct reports?
      - Can I check whether a specific object is one of a manager's reports?
      instructions:
      - text: Get direct report {report} of {user}.
        slots:
          report: path.directoryObject-id
          user: path.user-id
      - text: Look up {report} among the people reporting to {user}.
        slots:
          report: path.directoryObject-id
          user: path.user-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/directReports/{directoryObject-id}/microsoft.graph.orgContact'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a direct report as an org contact
      effect: read
      questions:
      - Can I read a direct report as an organizational contact?
      - What contact details come back when a direct report is an org contact?
      instructions:
      - text: Get direct report {report} of {user} cast as an organizational contact.
        slots:
          report: path.directoryObject-id
          user: path.user-id
      - text: Show {user}'s report {report} as an org contact record.
        slots:
          user: path.user-id
          report: path.directoryObject-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/directReports/{directoryObject-id}/microsoft.graph.user'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a direct report as a user
      effect: read
      questions:
      - How do I fetch one direct report typed as a user account?
      - Is there a way to get a report's full user properties by ID?
      instructions:
      - text: Get direct report {report} of {user} as a user object.
        slots:
          report: path.directoryObject-id
          user: path.user-id
      - text: Return {user}'s report {report} cast to a user account.
        slots:
          user: path.user-id
          report: path.directoryObject-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/directReports/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a user's direct reports
      effect: read
      questions:
      - How many direct reports does a manager have?
      - Can I count someone's reports that match a filter?
      instructions:
      - text: Count the direct reports of {user}.
        slots:
          user: path.user-id
      - text: Give me the number of {user}'s direct reports matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/directReports/microsoft.graph.orgContact'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's direct reports that are contacts
      effect: read
      questions:
      - Which of a manager's direct reports are organizational contacts rather than users?
      - Can I search only the contact-type direct reports?
      instructions:
      - text: List org contacts reporting directly to {user}.
        slots:
          user: path.user-id
      - text: Search {user}'s contact direct reports for {term}.
        slots:
          user: path.user-id
          term: query.$search
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/directReports/microsoft.graph.orgContact/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count direct reports that are org contacts
      effect: read
      questions:
      - How many organizational contacts report to a given manager?
      - Can I count contact reports that match a filter?
      instructions:
      - text: Count org contacts among {user}'s direct reports.
        slots:
          user: path.user-id
      - text: Count organizational contact reports of {user} matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/directReports/microsoft.graph.user'].get
  update:
    x-apievangelist-phrasing:
      intent: List direct reports that are users
      effect: read
      questions:
      - Which user accounts report directly to someone, excluding contacts?
      - Can I filter a manager's user-type reports by a property?
      instructions:
      - text: List user accounts reporting directly to {user}.
        slots:
          user: path.user-id
      - text: Filter {user}'s user-type direct reports by {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/directReports/microsoft.graph.user/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count direct reports that are users
      effect: read
      questions:
      - How many user accounts report directly to a manager?
      - What's the number of user-type reports under someone matching a filter?
      instructions:
      - text: Count user accounts that report directly to {user}.
        slots:
          user: path.user-id
      - text: Count {user}'s user-type reports matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/manager'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a user's manager
      effect: read
      questions:
      - Who is a given user's or agent user's manager?
      - Can I see whether a manager is a user or an organizational contact?
      instructions:
      - text: Get the manager of {user}.
        slots:
          user: path.user-id
      - text: Show full details of who {user} reports to.
        slots:
          user: path.user-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/manager/$ref'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a reference to a user's manager
      effect: read
      questions:
      - How do I get just the reference link to someone's manager instead of the full object?
      - Can I read the manager as an @odata.id reference?
      instructions:
      - text: Get the manager reference for {user}.
        slots:
          user: path.user-id
      - text: Return only the @odata.id link of {user}'s manager.
        slots:
          user: path.user-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/manager/$ref'].put
  update:
    x-apievangelist-phrasing:
      intent: Assign a user's manager
      effect: write
      questions:
      - How do I set who a user reports to?
      - Can I change a person's manager by pointing at another directory object?
      instructions:
      - text: Set {manager_ref} as the manager of {user}.
        slots:
          manager_ref: requestBody.@odata.id
          user: path.user-id
      - text: Make {user} report to the directory object {manager_ref}.
        slots:
          user: path.user-id
          manager_ref: requestBody.@odata.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/manager/$ref'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a user's manager
      effect: destructive
      questions:
      - How do I clear the manager assignment for a user or agent user?
      - Can I remove a manager only if the record's ETag still matches?
      instructions:
      - text: Remove the manager from {user}.
        slots:
          user: path.user-id
      - text: Unassign {user}'s manager if the ETag still matches {etag}.
        slots:
          user: path.user-id
          etag: header.If-Match
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/memberOf'].get
  update:
    x-apievangelist-phrasing:
      intent: List a user's direct memberships
      effect: read
      questions:
      - Which groups, directory roles and administrative units is a user directly a member of?
      - Can I filter a person's direct memberships?
      instructions:
      - text: List direct memberships of {user}.
        slots:
          user: path.user-id
      - text: Show groups and roles {user} directly belongs to matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/memberOf/{directoryObject-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one direct membership of a user
      effect: read
      questions:
      - How do I fetch a single group or role from a user's direct memberships?
      - Can I confirm a user is directly in a specific group by its ID?
      instructions:
      - text: Get membership {object} from {user}'s direct memberships.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      - text: Check whether {user} directly belongs to {object}.
        slots:
          user: path.user-id
          object: path.directoryObject-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/memberOf/{directoryObject-id}/microsoft.graph.administrativeUnit'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a direct membership as an administrative unit
      effect: read
      questions:
      - Can I fetch one of a user's direct memberships cast as an administrative unit?
      - What administrative unit details come back for a membership ID?
      instructions:
      - text: Get {object} from {user}'s direct memberships as an administrative unit.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      - text: Show the administrative unit {object} that {user} is directly in.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/memberOf/{directoryObject-id}/microsoft.graph.directoryRole'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a direct membership as a directory role
      effect: read
      questions:
      - Is there a way to read one of a user's direct memberships typed as a directory role?
      - What role details come back for one of someone's role memberships?
      instructions:
      - text: Get {object} from {user}'s direct memberships as a directory role.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      - text: Show directory role {object} that {user} directly holds.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/memberOf/{directoryObject-id}/microsoft.graph.group'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a direct membership as a group
      effect: read
      questions:
      - How do I get one of a user's direct memberships cast as a group?
      - Can I see group properties for a group a user belongs to directly?
      instructions:
      - text: Get {object} from {user}'s direct memberships as a group.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      - text: Show group {object} that {user} is a direct member of.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/memberOf/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a user's direct memberships
      effect: read
      questions:
      - How many groups, roles and units is a user directly a member of?
      - Can I count direct memberships that match a filter?
      instructions:
      - text: Count the direct memberships of {user}.
        slots:
          user: path.user-id
      - text: Count {user}'s direct memberships matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/memberOf/microsoft.graph.administrativeUnit'].get
  update:
    x-apievangelist-phrasing:
      intent: List administrative units a user is directly in
      effect: read
      questions:
      - Which administrative units is a user a direct member of?
      - Can I search a person's direct administrative unit memberships?
      instructions:
      - text: List administrative units {user} is directly a member of.
        slots:
          user: path.user-id
      - text: Search {user}'s direct administrative units for {term}.
        slots:
          user: path.user-id
          term: query.$search
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/memberOf/microsoft.graph.administrativeUnit/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count administrative units a user is directly in
      effect: read
      questions:
      - How many administrative units does a user directly belong to?
      - Can I count direct administrative unit memberships matching a filter?
      instructions:
      - text: Count administrative units {user} directly belongs to.
        slots:
          user: path.user-id
      - text: Count direct administrative units of {user} matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/memberOf/microsoft.graph.directoryRole'].get
  update:
    x-apievangelist-phrasing:
      intent: List directory roles a user directly holds
      effect: read
      questions:
      - Which directory roles is a user directly a member of?
      - Can I filter a person's directly held directory roles?
      instructions:
      - text: List directory roles {user} is directly a member of.
        slots:
          user: path.user-id
      - text: Filter {user}'s direct directory roles by {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/memberOf/microsoft.graph.directoryRole/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count directory roles a user directly holds
      effect: read
      questions:
      - How many directory roles does a user directly hold?
      - Can I count someone's direct role memberships that match a filter?
      instructions:
      - text: Count directory roles {user} directly holds.
        slots:
          user: path.user-id
      - text: Count direct directory role memberships of {user} matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/memberOf/microsoft.graph.group'].get
  update:
    x-apievangelist-phrasing:
      intent: List groups a user is directly in
      effect: read
      questions:
      - Which groups is a user a direct member of, leaving out roles and units?
      - Can I search the groups someone directly belongs to by name?
      instructions:
      - text: List only the groups {user} is directly in.
        slots:
          user: path.user-id
      - text: Search groups {user} directly belongs to for {term}.
        slots:
          user: path.user-id
          term: query.$search
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/memberOf/microsoft.graph.group/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count groups a user is directly in
      effect: read
      questions:
      - How many groups is a user directly a member of?
      - Can I count someone's direct group memberships matching a filter?
      instructions:
      - text: Count groups {user} is directly a member of.
        slots:
          user: path.user-id
      - text: Count direct group memberships of {user} matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedDevices'].get
  update:
    x-apievangelist-phrasing:
      intent: List devices a user owns
      effect: read
      questions:
      - Which devices does a user own?
      - Can I filter a person's owned devices?
      instructions:
      - text: List devices owned by {user}.
        slots:
          user: path.user-id
      - text: Show owned devices of {user} matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedDevices/{directoryObject-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one device a user owns
      effect: read
      questions:
      - How do I fetch a single device from a user's owned devices?
      - Can I look up one owned device by its object ID?
      instructions:
      - text: Get owned device {device} of {user}.
        slots:
          device: path.directoryObject-id
          user: path.user-id
      - text: Look up device {device} among those {user} owns.
        slots:
          device: path.directoryObject-id
          user: path.user-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedDevices/{directoryObject-id}/microsoft.graph.appRoleAssignment'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an owned-device entry as an app role assignment
      effect: read
      questions:
      - Can I read an item under a user's owned devices cast as an app role assignment?
      - What app role assignment data comes back for an owned-device ID?
      instructions:
      - text: Get {object} from {user}'s owned devices as an app role assignment.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      - text: Cast owned-device entry {object} of {user} to an app role assignment.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedDevices/{directoryObject-id}/microsoft.graph.device'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an owned device with full device properties
      effect: read
      questions:
      - How do I get one of a user's owned devices with full device properties?
      - Can I cast an owned-device entry to a device object?
      instructions:
      - text: Get owned device {device} of {user} as a device object.
        slots:
          device: path.directoryObject-id
          user: path.user-id
      - text: Return {user}'s owned item {device} typed as a device.
        slots:
          user: path.user-id
          device: path.directoryObject-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedDevices/{directoryObject-id}/microsoft.graph.endpoint'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an owned device as an endpoint
      effect: read
      questions:
      - Can I read one of a user's owned devices as an endpoint?
      - What endpoint details exist for an owned-device entry?
      instructions:
      - text: Get {object} from {user}'s owned devices as an endpoint.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      - text: Show owned endpoint {object} for {user}.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedDevices/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count devices a user owns
      effect: read
      questions:
      - How many devices does a user own?
      - Can I count owned devices that match a filter?
      instructions:
      - text: Count devices owned by {user}.
        slots:
          user: path.user-id
      - text: Count {user}'s owned devices matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedDevices/microsoft.graph.appRoleAssignment'].get
  update:
    x-apievangelist-phrasing:
      intent: List app role assignments in a user's owned devices
      effect: read
      questions:
      - Which app role assignments appear under a user's owned devices?
      - Can I search owned-device app role assignments?
      instructions:
      - text: List app role assignments among {user}'s owned devices.
        slots:
          user: path.user-id
      - text: Search owned-device app role assignments of {user} for {term}.
        slots:
          user: path.user-id
          term: query.$search
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedDevices/microsoft.graph.appRoleAssignment/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count app role assignments in owned devices
      effect: read
      questions:
      - How many app role assignments are listed under a user's owned devices?
      - Can I count owned-device app role assignments matching a filter?
      instructions:
      - text: Count app role assignments in {user}'s owned devices.
        slots:
          user: path.user-id
      - text: Count owned-device app role assignments of {user} matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedDevices/microsoft.graph.device'].get
  update:
    x-apievangelist-phrasing:
      intent: List device objects a user owns
      effect: read
      questions:
      - Which owned devices of a user are actual device objects?
      - Can I filter a user's owned devices by a device property?
      instructions:
      - text: List device objects owned by {user}.
        slots:
          user: path.user-id
      - text: Filter {user}'s owned device objects by {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedDevices/microsoft.graph.device/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count device objects a user owns
      effect: read
      questions:
      - How many device objects does a user own?
      - Can I count owned device objects matching a filter?
      instructions:
      - text: Count device objects owned by {user}.
        slots:
          user: path.user-id
      - text: Count {user}'s owned device objects matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedDevices/microsoft.graph.endpoint'].get
  update:
    x-apievangelist-phrasing:
      intent: List endpoints a user owns
      effect: read
      questions:
      - Which endpoints does a user own?
      - Can I search a user's owned endpoints?
      instructions:
      - text: List endpoints owned by {user}.
        slots:
          user: path.user-id
      - text: Search {user}'s owned endpoints for {term}.
        slots:
          user: path.user-id
          term: query.$search
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedDevices/microsoft.graph.endpoint/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count endpoints a user owns
      effect: read
      questions:
      - How many endpoints does a user own?
      - Can I count owned endpoints matching a filter?
      instructions:
      - text: Count endpoints owned by {user}.
        slots:
          user: path.user-id
      - text: Count owned endpoints of {user} matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedObjects'].get
  update:
    x-apievangelist-phrasing:
      intent: List directory objects a user owns
      effect: read
      questions:
      - Which directory objects does a user or agent user own?
      - Can I filter owned objects like apps and groups?
      instructions:
      - text: List directory objects owned by {user}.
        slots:
          user: path.user-id
      - text: Show objects {user} owns matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedObjects/{directoryObject-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one object a user owns
      effect: read
      questions:
      - How do I fetch one object from a user's owned objects?
      - Can I check if a user owns a specific directory object?
      instructions:
      - text: Get owned object {object} of {user}.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      - text: Look up {object} in what {user} owns.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedObjects/{directoryObject-id}/microsoft.graph.application'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an owned object as an application
      effect: read
      questions:
      - Can I fetch an object a user owns as an application registration?
      - What app registration details come back for an owned object ID?
      instructions:
      - text: Get {object} owned by {user} as an application.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      - text: Show app registration {object} that {user} owns.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedObjects/{directoryObject-id}/microsoft.graph.group'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an owned object as a group
      effect: read
      questions:
      - Can I read an object a user owns cast as a group?
      - What group properties come back for a group someone owns?
      instructions:
      - text: Get {object} owned by {user} as a group.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      - text: Show owned group {object} for {user}.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedObjects/{directoryObject-id}/microsoft.graph.servicePrincipal'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an owned object as a service principal
      effect: read
      questions:
      - Is it possible to read an owned object of a user as a service principal?
      - What service principal details come back for one someone owns?
      instructions:
      - text: Get {object} owned by {user} as a service principal.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      - text: Show owned service principal {object} for {user}.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedObjects/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count directory objects a user owns
      effect: read
      questions:
      - How many directory objects does a user own?
      - Is there a way to tally only the objects a user owns that fit a filter?
      instructions:
      - text: Count directory objects owned by {user}.
        slots:
          user: path.user-id
      - text: Count {user}'s owned objects matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedObjects/microsoft.graph.application'].get
  update:
    x-apievangelist-phrasing:
      intent: List applications a user owns
      effect: read
      questions:
      - Which application registrations does a user own?
      - Can I search the apps a person owns by name?
      instructions:
      - text: List applications owned by {user}.
        slots:
          user: path.user-id
      - text: Search {user}'s owned applications for {term}.
        slots:
          user: path.user-id
          term: query.$search
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedObjects/microsoft.graph.application/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count applications a user owns
      effect: read
      questions:
      - How many application registrations does a user own?
      - Can I count owned applications matching a filter?
      instructions:
      - text: Count applications owned by {user}.
        slots:
          user: path.user-id
      - text: Count owned applications of {user} matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedObjects/microsoft.graph.group'].get
  update:
    x-apievangelist-phrasing:
      intent: List groups a user owns
      effect: read
      questions:
      - Which groups does a user own?
      - Can I search the groups a person owns by name?
      instructions:
      - text: List groups owned by {user}.
        slots:
          user: path.user-id
      - text: Search {user}'s owned groups for {term}.
        slots:
          user: path.user-id
          term: query.$search
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedObjects/microsoft.graph.group/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count groups a user owns
      effect: read
      questions:
      - How many groups does a user own?
      - Can I count owned groups matching a filter?
      instructions:
      - text: Count groups owned by {user}.
        slots:
          user: path.user-id
      - text: Count owned groups of {user} matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedObjects/microsoft.graph.servicePrincipal'].get
  update:
    x-apievangelist-phrasing:
      intent: List service principals a user owns
      effect: read
      questions:
      - Which service principals does a user own?
      - Can I search the service principals a person owns?
      instructions:
      - text: List service principals owned by {user}.
        slots:
          user: path.user-id
      - text: Search {user}'s owned service principals for {term}.
        slots:
          user: path.user-id
          term: query.$search
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/ownedObjects/microsoft.graph.servicePrincipal/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count service principals a user owns
      effect: read
      questions:
      - How many service principals does a user own?
      - Can I count owned service principals matching a filter?
      instructions:
      - text: Count service principals owned by {user}.
        slots:
          user: path.user-id
      - text: Count owned service principals of {user} matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/registeredDevices'].get
  update:
    x-apievangelist-phrasing:
      intent: List devices registered for a user
      effect: read
      questions:
      - Which devices are registered for a user?
      - Can I filter the devices registered to someone?
      instructions:
      - text: List devices registered for {user}.
        slots:
          user: path.user-id
      - text: Show registered devices of {user} matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/registeredDevices/{directoryObject-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one device registered for a user
      effect: read
      questions:
      - How do I fetch one device from a user's registered devices?
      - Can I look up a single registered device by ID?
      instructions:
      - text: Get registered device {device} of {user}.
        slots:
          device: path.directoryObject-id
          user: path.user-id
      - text: Look up device {device} among those registered for {user}.
        slots:
          device: path.directoryObject-id
          user: path.user-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/registeredDevices/{directoryObject-id}/microsoft.graph.appRoleAssignment'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a registered-device entry as an app role assignment
      effect: read
      questions:
      - Can I read a registered-device entry of a user cast as an app role assignment?
      - Which app role assignment fields are returned for a registered-device ID?
      instructions:
      - text: Get {object} from {user}'s registered devices as an app role assignment.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      - text: Cast registered-device entry {object} of {user} to an app role assignment.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/registeredDevices/{directoryObject-id}/microsoft.graph.device'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a registered device with full device properties
      effect: read
      questions:
      - What full device properties can I read for a single device registered to a user?
      - Can I cast a registered-device entry to a device object?
      instructions:
      - text: Get registered device {device} of {user} as a device object.
        slots:
          device: path.directoryObject-id
          user: path.user-id
      - text: Return {user}'s registered item {device} typed as a device.
        slots:
          user: path.user-id
          device: path.directoryObject-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/registeredDevices/{directoryObject-id}/microsoft.graph.endpoint'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a registered device as an endpoint
      effect: read
      questions:
      - Can I read one registered device of a user as an endpoint?
      - Which endpoint properties exist for a device registered to someone?
      instructions:
      - text: Get {object} from {user}'s registered devices as an endpoint.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      - text: Show registered endpoint {object} for {user}.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/registeredDevices/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count devices registered for a user
      effect: read
      questions:
      - How many devices are registered for a user?
      - Can I count registered devices matching a filter?
      instructions:
      - text: Count devices registered for {user}.
        slots:
          user: path.user-id
      - text: Count {user}'s registered devices matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/registeredDevices/microsoft.graph.appRoleAssignment'].get
  update:
    x-apievangelist-phrasing:
      intent: List app role assignments in registered devices
      effect: read
      questions:
      - Are there app role assignments listed among the devices registered to a user?
      - Can I search registered-device app role assignments?
      instructions:
      - text: List app role assignments among {user}'s registered devices.
        slots:
          user: path.user-id
      - text: Search registered-device app role assignments of {user} for {term}.
        slots:
          user: path.user-id
          term: query.$search
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/registeredDevices/microsoft.graph.appRoleAssignment/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count app role assignments in registered devices
      effect: read
      questions:
      - How many app role assignments are in a user's registered devices list?
      - Can I count registered-device app role assignments matching a filter?
      instructions:
      - text: Count app role assignments in {user}'s registered devices.
        slots:
          user: path.user-id
      - text: Count registered-device app role assignments of {user} matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/registeredDevices/microsoft.graph.device'].get
  update:
    x-apievangelist-phrasing:
      intent: List device objects registered for a user
      effect: read
      questions:
      - Which registered entries for a user are actual device objects?
      - Can I filter a user's registered device objects by a property?
      instructions:
      - text: List device objects registered for {user}.
        slots:
          user: path.user-id
      - text: Filter {user}'s registered device objects by {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/registeredDevices/microsoft.graph.device/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count device objects registered for a user
      effect: read
      questions:
      - How many device objects are registered for a user?
      - Can I count registered device objects matching a filter?
      instructions:
      - text: Count device objects registered for {user}.
        slots:
          user: path.user-id
      - text: Count {user}'s registered device objects matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/registeredDevices/microsoft.graph.endpoint'].get
  update:
    x-apievangelist-phrasing:
      intent: List endpoints registered for a user
      effect: read
      questions:
      - Which endpoints are registered for a user?
      - Can I search a user's registered endpoints?
      instructions:
      - text: List endpoints registered for {user}.
        slots:
          user: path.user-id
      - text: Search {user}'s registered endpoints for {term}.
        slots:
          user: path.user-id
          term: query.$search
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/registeredDevices/microsoft.graph.endpoint/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count endpoints registered for a user
      effect: read
      questions:
      - How many endpoints are registered for a user?
      - Can I count registered endpoints matching a filter?
      instructions:
      - text: Count endpoints registered for {user}.
        slots:
          user: path.user-id
      - text: Count registered endpoints of {user} matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/sponsorOf'].get
  update:
    x-apievangelist-phrasing:
      intent: List objects a user sponsors
      effect: read
      questions:
      - Which guest users, agent users or groups does a person sponsor?
      - Can I filter the objects a user sponsors?
      instructions:
      - text: List everything {user} sponsors.
        slots:
          user: path.user-id
      - text: Show objects sponsored by {user} matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/sponsorOf/{directoryObject-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one object a user sponsors
      effect: read
      questions:
      - How do I fetch one object a user sponsors?
      - Can I confirm a user sponsors a specific guest or agent?
      instructions:
      - text: Get sponsored object {object} of {user}.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      - text: Look up {object} among what {user} sponsors.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/sponsorOf/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count objects a user sponsors
      effect: read
      questions:
      - How many objects does a user sponsor?
      - Can I count sponsored objects matching a filter?
      instructions:
      - text: Count the objects {user} sponsors.
        slots:
          user: path.user-id
      - text: Count objects sponsored by {user} matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/sponsors'].get
  update:
    x-apievangelist-phrasing:
      intent: List an agent user's sponsors
      effect: read
      questions:
      - Who are the sponsors responsible for an agent user?
      - Can I filter an agent user's sponsors?
      instructions:
      - text: List the sponsors of {user}.
        slots:
          user: path.user-id
      - text: Show sponsors of agent user {user} matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/sponsors/{directoryObject-id}/$ref'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a specific sponsor from an agent user
      effect: destructive
      questions:
      - How do I remove one sponsor from an agent user when I know the sponsor's ID?
      - Can I unassign a sponsor only when the ETag matches?
      instructions:
      - text: Remove sponsor {sponsor} from agent user {user}.
        slots:
          sponsor: path.directoryObject-id
          user: path.user-id
      - text: Unassign sponsor {sponsor} from {user} if the ETag is {etag}.
        slots:
          sponsor: path.directoryObject-id
          user: path.user-id
          etag: header.If-Match
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/sponsors/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count an agent user's sponsors
      effect: read
      questions:
      - How many sponsors does an agent user have?
      - Can I count an agent user's sponsors matching a filter?
      instructions:
      - text: Count the sponsors of {user}.
        slots:
          user: path.user-id
      - text: Count sponsors of agent user {user} matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/sponsors/$ref'].get
  update:
    x-apievangelist-phrasing:
      intent: List sponsor references of an agent user
      effect: read
      questions:
      - Can I get just the reference links to an agent user's sponsors?
      - How do I list sponsor IDs as @odata.id references?
      instructions:
      - text: List sponsor references for {user}.
        slots:
          user: path.user-id
      - text: Return @odata.id links of sponsors of {user} matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/sponsors/$ref'].post
  update:
    x-apievangelist-phrasing:
      intent: Add a sponsor to an agent user
      effect: write
      questions:
      - How do I assign a sponsor to an agent user?
      - Can a group be made responsible as an agent user's sponsor?
      instructions:
      - text: Add {sponsor_ref} as a sponsor of {user}.
        slots:
          sponsor_ref: requestBody.@odata.id
          user: path.user-id
      - text: Assign the user or group {sponsor_ref} to sponsor agent user {user}.
        slots:
          sponsor_ref: requestBody.@odata.id
          user: path.user-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/sponsors/$ref'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a sponsor by reference from an agent user
      effect: destructive
      questions:
      - Can I remove an agent user's sponsor by passing its reference as a query parameter?
      - What's the way to drop a sponsor using the @id reference rather than a path ID?
      instructions:
      - text: Remove the sponsor referenced by {sponsor_query} from {user}.
        slots:
          sponsor_query: query.@id
          user: path.user-id
      - text: Delete sponsor reference {sponsor_query} on agent user {user} if the ETag matches {etag}.
        slots:
          sponsor_query: query.@id
          user: path.user-id
          etag: header.If-Match
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/transitiveMemberOf'].get
  update:
    x-apievangelist-phrasing:
      intent: List all of a user's memberships including nested
      effect: read
      questions:
      - Which groups, roles and units is a user a member of, including through nested groups?
      - Can I filter a person's transitive memberships?
      instructions:
      - text: List all memberships of {user} including nested groups.
        slots:
          user: path.user-id
      - text: Show transitive memberships of {user} matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/transitiveMemberOf/{directoryObject-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one transitive membership of a user
      effect: read
      questions:
      - How do I check whether a user belongs to a group directly or through nesting?
      - Can I fetch one transitive membership by ID?
      instructions:
      - text: Get transitive membership {object} of {user}.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      - text: Check if {user} is in {object} directly or via nested groups.
        slots:
          user: path.user-id
          object: path.directoryObject-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/transitiveMemberOf/{directoryObject-id}/microsoft.graph.administrativeUnit'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a transitive membership as an administrative unit
      effect: read
      questions:
      - Can I fetch a user's transitive membership cast as an administrative unit?
      - What unit details come back for an inherited administrative unit membership?
      instructions:
      - text: Get {object} from {user}'s transitive memberships as an administrative unit.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      - text: Show inherited administrative unit {object} of {user}.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/transitiveMemberOf/{directoryObject-id}/microsoft.graph.directoryRole'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a transitive membership as a directory role
      effect: read
      questions:
      - Can I read a user's transitive membership typed as a directory role?
      - What role details come back for a role a user holds directly or indirectly?
      instructions:
      - text: Get {object} from {user}'s transitive memberships as a directory role.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      - text: Show directory role {object} held by {user} through any membership path.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/transitiveMemberOf/{directoryObject-id}/microsoft.graph.group'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a transitive membership as a group
      effect: read
      questions:
      - How do I get a group from a user's transitive memberships?
      - Can I see group properties for a nested group a user inherits?
      instructions:
      - text: Get {object} from {user}'s transitive memberships as a group.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      - text: Show nested or direct group {object} for {user}.
        slots:
          object: path.directoryObject-id
          user: path.user-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/transitiveMemberOf/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count all of a user's memberships including nested
      effect: read
      questions:
      - How many groups, roles and units does a user belong to, counting nested ones?
      - Can I count transitive memberships matching a filter?
      instructions:
      - text: Count all memberships of {user} including nested.
        slots:
          user: path.user-id
      - text: Count transitive memberships of {user} matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/transitiveMemberOf/microsoft.graph.administrativeUnit'].get
  update:
    x-apievangelist-phrasing:
      intent: List administrative units a user is in transitively
      effect: read
      questions:
      - Which administrative units is a user in, directly or through nesting?
      - Can I search a user's transitive administrative units?
      instructions:
      - text: List administrative units {user} belongs to transitively.
        slots:
          user: path.user-id
      - text: Search transitive administrative units of {user} for {term}.
        slots:
          user: path.user-id
          term: query.$search
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/transitiveMemberOf/microsoft.graph.administrativeUnit/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count administrative units a user is in transitively
      effect: read
      questions:
      - How many administrative units does a user belong to including nested membership?
      - Can I count a person's transitive administrative units matching a filter?
      instructions:
      - text: Count transitive administrative units of {user}.
        slots:
          user: path.user-id
      - text: Count administrative units {user} reaches through nesting matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/transitiveMemberOf/microsoft.graph.directoryRole'].get
  update:
    x-apievangelist-phrasing:
      intent: List directory roles a user holds transitively
      effect: read
      questions:
      - Which directory roles does a user hold, including via group membership?
      - Can I filter a user's transitive directory roles?
      instructions:
      - text: List directory roles {user} holds transitively.
        slots:
          user: path.user-id
      - text: Filter transitive directory roles of {user} by {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/transitiveMemberOf/microsoft.graph.directoryRole/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count directory roles a user holds transitively
      effect: read
      questions:
      - How many directory roles does a user have counting inherited ones?
      - Can I count transitive directory roles matching a filter?
      instructions:
      - text: Count transitive directory roles of {user}.
        slots:
          user: path.user-id
      - text: Count directory roles {user} inherits or holds matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/transitiveMemberOf/microsoft.graph.group'].get
  update:
    x-apievangelist-phrasing:
      intent: List all groups a user is in including nested
      effect: read
      questions:
      - Which groups is a user in when nested groups are included?
      - Can I search all of a user's groups, direct and nested, by name?
      instructions:
      - text: List every group {user} belongs to including nested.
        slots:
          user: path.user-id
      - text: Search transitive groups of {user} for {term}.
        slots:
          user: path.user-id
          term: query.$search
      method: generated
      generated: '2026-10-01'
- target: $.paths['/users/{user-id}/transitiveMemberOf/microsoft.graph.group/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count all groups a user is in including nested
      effect: read
      questions:
      - How many groups does a user belong to counting nested memberships?
      - Can I tally only the nested and direct groups of a user that fit a filter?
      instructions:
      - text: Count all groups {user} is in including nested.
        slots:
          user: path.user-id
      - text: Count transitive groups of {user} matching {filter}.
        slots:
          user: path.user-id
          filter: query.$filter
      method: generated
      generated: '2026-10-01'