# 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.org Contact.Actions…
  version: 1.0.0
extends: openapi/azure-ad-contacts-orgcontact-actions-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 9
- target: $.paths['/contacts/{orgContact-id}/microsoft.graph.checkMemberGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: Check an org contact's membership in given groups
      effect: read
      questions:
      - How do I check whether an organizational contact belongs to any of a list of groups?
      - Which of these specific group IDs is a given contact a member of?
      instructions:
      - text: Check which of groups {groupIds} org contact {contact} is a member of.
        slots:
          groupIds: requestBody.groupIds
          contact: path.orgContact-id
      - text: 'Tell me if contact {contact} is in any of these groups: {groupIds}.'
        slots:
          contact: path.orgContact-id
          groupIds: requestBody.groupIds
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/microsoft.graph.checkMemberObjects'].post
  update:
    x-apievangelist-phrasing:
      intent: Check an org contact's membership in given objects
      effect: read
      questions:
      - Can I test an organizational contact against a mixed list of groups, roles and admin units?
      - Which of a set of directory object IDs does a contact belong to?
      instructions:
      - text: Check which of directory objects {ids} org contact {contact} is a member of.
        slots:
          ids: requestBody.ids
          contact: path.orgContact-id
      - text: Verify contact {contact}'s membership against object IDs {ids}.
        slots:
          contact: path.orgContact-id
          ids: requestBody.ids
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/microsoft.graph.getMemberGroups'].post
  update:
    x-apievangelist-phrasing:
      intent: List all groups an org contact belongs to
      effect: read
      questions:
      - What are all the group IDs an organizational contact is a member of?
      - Can I restrict an org contact's group list to security-enabled groups only?
      instructions:
      - text: Get every group ID org contact {contact} belongs to.
        slots:
          contact: path.orgContact-id
      - text: List the groups of contact {contact} with security-enabled-only set to {securityOnly}.
        slots:
          contact: path.orgContact-id
          securityOnly: requestBody.securityEnabledOnly
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/microsoft.graph.getMemberObjects'].post
  update:
    x-apievangelist-phrasing:
      intent: List groups, roles and admin units of an org contact
      effect: read
      questions:
      - Which groups, administrative units and directory roles is an organizational contact part of?
      - Can I get all of a contact's memberships, not just groups?
      instructions:
      - text: Get all group, role and administrative unit IDs for org contact {contact}.
        slots:
          contact: path.orgContact-id
      - text: 'List every membership object of contact {contact}, security-enabled only: {securityOnly}.'
        slots:
          contact: path.orgContact-id
          securityOnly: requestBody.securityEnabledOnly
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/microsoft.graph.restore'].post
  update:
    x-apievangelist-phrasing:
      intent: Restore a deleted organizational contact
      effect: write
      questions:
      - How do I bring back an organizational contact that was recently deleted?
      - Can a deleted org contact be recovered from deleted items?
      instructions:
      - text: Restore deleted organizational contact {contact}.
        slots:
          contact: path.orgContact-id
      - text: Recover org contact {contact} from the directory's deleted items.
        slots:
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/{orgContact-id}/microsoft.graph.retryServiceProvisioning'].post
  update:
    x-apievangelist-phrasing:
      intent: Retry provisioning for an org contact
      effect: write
      questions:
      - An organizational contact failed to provision to a service; can I retry it?
      - Is there a way to re-run service provisioning for one contact?
      instructions:
      - text: Retry service provisioning for org contact {contact}.
        slots:
          contact: path.orgContact-id
      - text: Kick off provisioning again for contact {contact}.
        slots:
          contact: path.orgContact-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/microsoft.graph.getAvailableExtensionProperties'].post
  update:
    x-apievangelist-phrasing:
      intent: List directory extension properties available
      effect: read
      questions:
      - What directory extension properties are registered in our tenant, including from multitenant apps?
      - Can I see only the extension properties synced from on-premises?
      instructions:
      - text: List all directory extension definitions registered in our directory.
      - text: Get available extension properties where synced-from-on-premises is {synced}.
        slots:
          synced: requestBody.isSyncedFromOnPremises
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/microsoft.graph.getByIds'].post
  update:
    x-apievangelist-phrasing:
      intent: Look up directory objects by a list of IDs
      effect: read
      questions:
      - How can I resolve a batch of object IDs to their directory objects in one call?
      - Can I limit an ID lookup to certain object types like orgContact or user?
      instructions:
      - text: Get the directory objects for IDs {ids}.
        slots:
          ids: requestBody.ids
      - text: Resolve IDs {ids} restricted to types {types}.
        slots:
          ids: requestBody.ids
          types: requestBody.types
      method: generated
      generated: '2026-10-01'
- target: $.paths['/contacts/microsoft.graph.validateProperties'].post
  update:
    x-apievangelist-phrasing:
      intent: Check a group name against naming policy
      effect: read
      questions:
      - Will a proposed Microsoft 365 group display name pass our naming policy?
      - Can I check a mail nickname for blocked words before creating a group?
      instructions:
      - text: Validate display name {displayName} against the group naming policy.
        slots:
          displayName: requestBody.displayName
      - text: Check mail nickname {mailNickname} for a {entityType} on behalf of user {userId}.
        slots:
          mailNickname: requestBody.mailNickname
          entityType: requestBody.entityType
          userId: requestBody.onBehalfOfUserId
      method: generated
      generated: '2026-10-01'