# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Identity.DirectoryManagement Contacts.directory Object API
  version: 1.0.0
extends: openapi/azure-ad-contacts-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: 28
- target: $.paths['/contacts/{orgContact-id}/directReports'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organizational contact's direct reports
      effect: read
      questions:
      - Who reports directly to this external contact in our directory?
      - How do I see every user and contact whose manager is set to an organizational contact?
      instructions:
      - text: List the direct reports of contact {contact}.
        slots:
          contact: path.orgContact-id
      - text: Show everyone who has organizational contact {contact} as their manager, users and contacts alike.
        slots:
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/directReports/{directoryObject-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one direct report of an organizational contact
      effect: read
      questions:
      - Can I look up a single direct report of an org contact by its object ID?
      - What details come back for one specific person reporting to an external contact?
      instructions:
      - text: Get direct report {report} of contact {contact}.
        slots:
          report: path.directoryObject-id
          contact: path.orgContact-id
      - text: Fetch the directory object {report} from the direct reports of org contact {contact}, whatever its type.
        slots:
          report: path.directoryObject-id
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/directReports/{directoryObject-id}/microsoft.graph.orgContact'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a contact's direct report cast as an org contact
      effect: read
      questions:
      - How do I read a direct report of an org contact when that report is itself an organizational contact?
      - Can I get contact-specific fields for a direct report that is another external contact?
      instructions:
      - text: Get direct report {report} of contact {contact} as an organizational contact.
        slots:
          report: path.directoryObject-id
          contact: path.orgContact-id
      - text: Return the orgContact properties of report {report} under contact {contact}.
        slots:
          report: path.directoryObject-id
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/directReports/{directoryObject-id}/microsoft.graph.user'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a contact's direct report cast as a user
      effect: read
      questions:
      - How do I get user properties for someone who reports to an organizational contact?
      - Can I read a direct report of an org contact as a full user object?
      instructions:
      - text: Get direct report {report} of contact {contact} as a user.
        slots:
          report: path.directoryObject-id
          contact: path.orgContact-id
      - text: Show the user record for report {report} who reports to org contact {contact}.
        slots:
          report: path.directoryObject-id
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/directReports/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count an organizational contact's direct reports
      effect: read
      questions:
      - How many people report directly to this organizational contact?
      - What is the total number of direct reports, of any type, under an external contact?
      instructions:
      - text: Count the direct reports of contact {contact}.
        slots:
          contact: path.orgContact-id
      - text: Tell me how many directory objects report to org contact {contact}.
        slots:
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/directReports/microsoft.graph.orgContact'].get
  update:
    x-apievangelist-phrasing:
      intent: List a contact's direct reports that are org contacts
      effect: read
      questions:
      - Which of an org contact's direct reports are themselves organizational contacts?
      - Can I list only the external contacts that report to a contact, leaving out users?
      instructions:
      - text: List only the organizational contacts reporting to contact {contact}.
        slots:
          contact: path.orgContact-id
      - text: Show the direct reports of org contact {contact}, filtered to contact objects.
        slots:
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/directReports/microsoft.graph.orgContact/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a contact's direct reports that are org contacts
      effect: read
      questions:
      - How many organizational contacts report to this contact?
      - What's the count of external contacts, not users, under an org contact?
      instructions:
      - text: Count the organizational contacts that report to contact {contact}.
        slots:
          contact: path.orgContact-id
      - text: Give me the number of contact-type direct reports for org contact {contact}.
        slots:
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/directReports/microsoft.graph.user'].get
  update:
    x-apievangelist-phrasing:
      intent: List a contact's direct reports that are users
      effect: read
      questions:
      - Which users in our tenant report to an organizational contact?
      - Can I get just the user accounts among an external contact's direct reports?
      instructions:
      - text: List only the users reporting to contact {contact}.
        slots:
          contact: path.orgContact-id
      - text: Show the direct reports of org contact {contact}, filtered to user accounts.
        slots:
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/directReports/microsoft.graph.user/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count a contact's direct reports that are users
      effect: read
      questions:
      - How many user accounts report to this organizational contact?
      - What's the number of users, excluding contacts, managed by an external contact?
      instructions:
      - text: Count the users that report to contact {contact}.
        slots:
          contact: path.orgContact-id
      - text: Report the total of user accounts, excluding contacts, that report to org contact {contact}.
        slots:
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/manager'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an organizational contact's manager
      effect: read
      questions:
      - Who is the manager of this external contact in Microsoft Entra ID?
      - Can I find out which person an organizational contact reports to?
      instructions:
      - text: Get the manager of contact {contact}.
        slots:
          contact: path.orgContact-id
      - text: Show who org contact {contact} reports to.
        slots:
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/memberOf'].get
  update:
    x-apievangelist-phrasing:
      intent: List groups an org contact directly belongs to
      effect: read
      questions:
      - Which groups is this organizational contact a direct member of?
      - How do I see the direct memberships of an external contact, without nested groups?
      instructions:
      - text: List the groups contact {contact} is directly a member of.
        slots:
          contact: path.orgContact-id
      - text: Show the direct memberOf entries for org contact {contact}.
        slots:
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/memberOf/{directoryObject-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one direct membership of an org contact
      effect: read
      questions:
      - Can I check a single group that an org contact directly belongs to by its ID?
      - What does one direct memberOf entry for an external contact look like?
      instructions:
      - text: Get direct membership {group} of contact {contact}.
        slots:
          group: path.directoryObject-id
          contact: path.orgContact-id
      - text: Fetch the object {group} from the direct memberOf list of org contact {contact}.
        slots:
          group: path.directoryObject-id
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/memberOf/{directoryObject-id}/microsoft.graph.administrativeUnit'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an org contact's direct admin unit membership
      effect: read
      questions:
      - How do I read an administrative unit that an org contact is directly in?
      - Can I get administrative unit details for one of a contact's direct memberships?
      instructions:
      - text: Get direct membership {unit} of contact {contact} as an administrative unit.
        slots:
          unit: path.directoryObject-id
          contact: path.orgContact-id
      - text: Show the administrative unit {unit} that org contact {contact} directly belongs to.
        slots:
          unit: path.directoryObject-id
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/memberOf/{directoryObject-id}/microsoft.graph.group'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an org contact's direct group membership as a group
      effect: read
      questions:
      - How do I get full group properties for a group an org contact is directly in?
      - Can I read one of an external contact's direct memberships as a group object?
      instructions:
      - text: Get direct membership {group} of contact {contact} as a group.
        slots:
          group: path.directoryObject-id
          contact: path.orgContact-id
      - text: Show the group record {group} that org contact {contact} directly belongs to.
        slots:
          group: path.directoryObject-id
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/memberOf/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count an org contact's direct memberships
      effect: read
      questions:
      - How many groups and units is an organizational contact directly a member of?
      - What is the count of direct memberOf entries for an external contact?
      instructions:
      - text: Count the direct memberships of contact {contact}.
        slots:
          contact: path.orgContact-id
      - text: Tell me how many objects org contact {contact} is directly a member of.
        slots:
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/memberOf/microsoft.graph.administrativeUnit'].get
  update:
    x-apievangelist-phrasing:
      intent: List admin units an org contact directly belongs to
      effect: read
      questions:
      - Which administrative units directly include this organizational contact?
      - Can I list only admin units, not groups, among a contact's direct memberships?
      instructions:
      - text: List the administrative units contact {contact} is directly in.
        slots:
          contact: path.orgContact-id
      - text: Show the direct memberOf of org contact {contact}, filtered to administrative units.
        slots:
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/memberOf/microsoft.graph.administrativeUnit/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count admin units an org contact directly belongs to
      effect: read
      questions:
      - How many administrative units is this org contact directly a member of?
      - What's the number of direct admin unit memberships for an external contact?
      instructions:
      - text: Count the administrative units contact {contact} directly belongs to.
        slots:
          contact: path.orgContact-id
      - text: Give me the direct admin unit membership count for org contact {contact}.
        slots:
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/memberOf/microsoft.graph.group'].get
  update:
    x-apievangelist-phrasing:
      intent: List groups, only, an org contact directly belongs to
      effect: read
      questions:
      - Which groups, excluding administrative units, is a contact directly a member of?
      - Can I list the direct group memberships of an external contact as group objects?
      instructions:
      - text: List only the groups contact {contact} is directly in, as group objects.
        slots:
          contact: path.orgContact-id
      - text: Show the direct memberOf of org contact {contact}, filtered to groups.
        slots:
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/memberOf/microsoft.graph.group/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count groups an org contact directly belongs to
      effect: read
      questions:
      - How many groups is this org contact directly a member of, not counting admin units?
      - What's the direct group membership count for an external contact?
      instructions:
      - text: Count the groups contact {contact} directly belongs to.
        slots:
          contact: path.orgContact-id
      - text: Give me the direct group-only membership count for org contact {contact}.
        slots:
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/transitiveMemberOf'].get
  update:
    x-apievangelist-phrasing:
      intent: List all groups an org contact belongs to, nested
      effect: read
      questions:
      - Which groups is an organizational contact in, including groups it's nested under?
      - How do I get the full transitive group membership of an external contact?
      instructions:
      - text: List every group contact {contact} belongs to, including nested memberships.
        slots:
          contact: path.orgContact-id
      - text: Show the transitive memberOf of org contact {contact}.
        slots:
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/transitiveMemberOf/{directoryObject-id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one transitive membership of an org contact
      effect: read
      questions:
      - Can I check whether one nested group is among an org contact's transitive memberships?
      - What does a single transitive memberOf entry for a contact return?
      instructions:
      - text: Get transitive membership {group} of contact {contact}.
        slots:
          group: path.directoryObject-id
          contact: path.orgContact-id
      - text: Fetch object {group} from the nested memberships of org contact {contact}.
        slots:
          group: path.directoryObject-id
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/transitiveMemberOf/{directoryObject-id}/microsoft.graph.administrativeUnit'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an org contact's nested admin unit membership
      effect: read
      questions:
      - How do I read an administrative unit a contact belongs to through nesting?
      - Can I get admin unit details for one of an org contact's transitive memberships?
      instructions:
      - text: Get transitive membership {unit} of contact {contact} as an administrative unit.
        slots:
          unit: path.directoryObject-id
          contact: path.orgContact-id
      - text: Show the administrative unit {unit} that org contact {contact} belongs to directly or indirectly.
        slots:
          unit: path.directoryObject-id
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/transitiveMemberOf/{directoryObject-id}/microsoft.graph.group'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an org contact's nested group membership as a group
      effect: read
      questions:
      - How do I get group properties for a group a contact is in through nested membership?
      - Can I read one of an org contact's transitive memberships as a group object?
      instructions:
      - text: Get transitive membership {group} of contact {contact} as a group.
        slots:
          group: path.directoryObject-id
          contact: path.orgContact-id
      - text: Show the group record {group} that org contact {contact} belongs to directly or through nesting.
        slots:
          group: path.directoryObject-id
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/transitiveMemberOf/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count an org contact's transitive memberships
      effect: read
      questions:
      - How many groups and units is an org contact in once nested memberships are included?
      - What's the total transitive membership count for an external contact?
      instructions:
      - text: Count all memberships of contact {contact}, including nested ones.
        slots:
          contact: path.orgContact-id
      - text: Tell me the transitive memberOf count for org contact {contact}.
        slots:
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/transitiveMemberOf/microsoft.graph.administrativeUnit'].get
  update:
    x-apievangelist-phrasing:
      intent: List admin units an org contact belongs to, nested
      effect: read
      questions:
      - Which administrative units include this contact directly or through nesting?
      - Can I list only admin units among an org contact's transitive memberships?
      instructions:
      - text: List the administrative units contact {contact} belongs to, including nested ones.
        slots:
          contact: path.orgContact-id
      - text: Show the transitive memberOf of org contact {contact}, filtered to administrative units.
        slots:
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/transitiveMemberOf/microsoft.graph.administrativeUnit/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count admin units an org contact is in, nested
      effect: read
      questions:
      - How many administrative units is an org contact in once nesting is counted?
      - What's the transitive admin unit membership count for an external contact?
      instructions:
      - text: Count the administrative units contact {contact} belongs to, including nested ones.
        slots:
          contact: path.orgContact-id
      - text: Give me the transitive admin unit count for org contact {contact}.
        slots:
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/transitiveMemberOf/microsoft.graph.group'].get
  update:
    x-apievangelist-phrasing:
      intent: List groups, only, an org contact is in, nested
      effect: read
      questions:
      - Which groups, not admin units, contain this contact directly or through nesting?
      - Can I list an org contact's transitive memberships as group objects only?
      instructions:
      - text: List only the groups contact {contact} belongs to, including nested groups.
        slots:
          contact: path.orgContact-id
      - text: Show the transitive memberOf of org contact {contact}, filtered to groups.
        slots:
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/transitiveMemberOf/microsoft.graph.group/$count'].get
  update:
    x-apievangelist-phrasing:
      intent: Count groups an org contact is in, nested
      effect: read
      questions:
      - How many groups is an org contact in once nested group membership is counted?
      - What's the transitive group-only membership count for an external contact?
      instructions:
      - text: Count the groups contact {contact} belongs to, including nested groups.
        slots:
          contact: path.orgContact-id
      - text: Give me the transitive group count for org contact {contact}.
        slots:
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'