API Evangelist conversational phrasing for Users.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 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'


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