# 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 Organization.organization.Actio… version: 1.0.0 extends: openapi/azure-ad-organization-organization-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['/organization/{organization-id}/microsoft.graph.checkMemberGroups'].post update: x-apievangelist-phrasing: intent: Check an organization's membership in groups effect: read questions: - Is this directory object a member of any of these specific groups? - How many group IDs can I check for membership in a single request? instructions: - text: Check which of groups {groups} organization {org} is a member of. slots: groups: requestBody.groupIds org: path.organization-id - text: For organization {org}, test membership in group IDs {groups}. slots: org: path.organization-id groups: requestBody.groupIds method: generated generated: '2026-10-01' - target: $.paths['/organization/{organization-id}/microsoft.graph.checkMemberObjects'].post update: x-apievangelist-phrasing: intent: Check an organization's membership in objects effect: read questions: - Can I check membership against a mixed list of groups, roles and administrative units? - Which of a list of directory object IDs does an organization object belong to? instructions: - text: Check which of objects {ids} organization {org} is a member of. slots: ids: requestBody.ids org: path.organization-id - text: Test organization {org} for membership in directory objects {ids}. slots: org: path.organization-id ids: requestBody.ids method: generated generated: '2026-10-01' - target: $.paths['/organization/{organization-id}/microsoft.graph.getMemberGroups'].post update: x-apievangelist-phrasing: intent: Get all groups an organization belongs to effect: read questions: - What groups does an organization object belong to, including transitive membership? - Can I limit the membership lookup to security-enabled groups only? - What happens when there are more than 11,000 group memberships? instructions: - text: Get every group ID organization {org} is a member of. slots: org: path.organization-id - text: 'List group memberships of organization {org}, security groups only: {securityOnly}.' slots: org: path.organization-id securityOnly: requestBody.securityEnabledOnly method: generated generated: '2026-10-01' - target: $.paths['/organization/{organization-id}/microsoft.graph.getMemberObjects'].post update: x-apievangelist-phrasing: intent: Get groups, units and roles an org belongs to effect: read questions: - Which groups, administrative units and directory roles is an organization object a member of? - Does getMemberObjects include directory roles as well as groups? instructions: - text: Get all member-of object IDs for organization {org}. slots: org: path.organization-id - text: List groups, admin units and roles containing organization {org}, security-enabled only {securityOnly}. slots: org: path.organization-id securityOnly: requestBody.securityEnabledOnly method: generated generated: '2026-10-01' - target: $.paths['/organization/{organization-id}/microsoft.graph.restore'].post update: x-apievangelist-phrasing: intent: Restore a deleted directory object effect: write questions: - How do I restore a recently deleted user, group or application from deleted items? - Does restoring an application also bring back its service principal? instructions: - text: Restore deleted directory object {org}. slots: org: path.organization-id - text: Undelete object {org} from deleted items via the organization restore action. slots: org: path.organization-id method: generated generated: '2026-10-01' - target: $.paths['/organization/{organization-id}/microsoft.graph.setMobileDeviceManagementAuthority'].post update: x-apievangelist-phrasing: intent: Set the mobile device management authority effect: write questions: - How do I set the mobile device management authority for my organization? - Can I configure MDM authority for a tenant through Microsoft Graph? instructions: - text: Set the mobile device management authority for organization {org}. slots: org: path.organization-id - text: Configure MDM authority on tenant {org}. slots: org: path.organization-id method: generated generated: '2026-10-01' - target: $.paths['/organization/microsoft.graph.getAvailableExtensionProperties'].post update: x-apievangelist-phrasing: intent: List available directory extension properties effect: read questions: - Which directory extension properties are registered in my tenant, including from multitenant apps? - Can I list only the extension properties synced from on-premises? instructions: - text: List all directory extension properties available in the tenant. - text: Show extension properties where synced from on-premises is {synced}. slots: synced: requestBody.isSyncedFromOnPremises method: generated generated: '2026-10-01' - target: $.paths['/organization/microsoft.graph.getByIds'].post update: x-apievangelist-phrasing: intent: Get directory objects by their IDs effect: read questions: - How do I resolve a batch of object IDs to users, groups and devices in one call? - Can I restrict an ID lookup to certain object types like user or group? instructions: - text: Get directory objects for IDs {ids}. slots: ids: requestBody.ids - text: Resolve IDs {ids} limited to types {types}. slots: ids: requestBody.ids types: requestBody.types method: generated generated: '2026-10-01' - target: $.paths['/organization/microsoft.graph.validateProperties'].post update: x-apievangelist-phrasing: intent: Validate a Microsoft 365 group name effect: read questions: - Does a proposed Microsoft 365 group name comply with our naming policy and banned words? - Can I check a mail nickname is unique before creating a group? instructions: - text: Validate display name {name} and mail nickname {nickname} for a new group. slots: name: requestBody.displayName nickname: requestBody.mailNickname - text: Check {name} against group naming policy on behalf of user {user}. slots: name: requestBody.displayName user: requestBody.onBehalfOfUserId method: generated generated: '2026-10-01'