Microsoft Entra ID (formerly Azure AD) · OpenAPI Overlay 1.0.0

API Evangelist conversational phrasing for Groups.group.Functions API

5 actions 5 updates phrasing extends openapi/azure-ad-groups-group-functions-api-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for Microsoft Entra ID (formerly Azure AD)'s API. It is a proposal applied on top of the contract, not a document Microsoft Entra ID (formerly Azure AD) publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-apievangelist-phrasing

Targets 5

$.info

$.paths['/groups/{group-id}/sites/{site-id}/microsoft.graph.getByPath(path=\'{path}\')/microsoft.graph.getActivitiesByInterval()'].get

$.paths['/groups/{group-id}/sites/{site-id}/microsoft.graph.getByPath(path=\'{path}\')/microsoft.graph.getActivitiesByInterval(startDateTime=\'{startDateTime}\',endDateTime=\'{endDateTime}\',interval=\'{interval}\')'].get

$.paths['/groups/{group-id}/sites/{site-id}/microsoft.graph.getByPath(path=\'{path}\')/microsoft.graph.getApplicableContentTypesForList(listId=\'{listId}\')'].get

$.paths['/groups/microsoft.graph.delta()'].get

OpenAPI Overlay

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Groups.group.Functions API
  version: 1.0.0
extends: openapi/azure-ad-groups-group-functions-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: 4
- target: $.paths['/groups/{group-id}/sites/{site-id}/microsoft.graph.getByPath(path=\'{path}\')/microsoft.graph.getActivitiesByInterval()'].get
  update:
    x-apievangelist-phrasing:
      intent: Get default activity stats for a group site path
      effect: read
      questions:
      - What activity has a site path in a group's site seen, without picking dates or an interval?
      - Can I page through the default activity stats for a site addressed by its path?
      instructions:
      - text: Get the default activity stats for path {path} on site {site} of group {group}, with no date range.
        slots:
          path: path.path
          site: path.site-id
          group: path.group-id
      - text: Show the top {top} activity records for site path {path} in group {group} site {site}, using default dates.
        slots:
          top: query.$top
          path: path.path
          group: path.group-id
          site: path.site-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/sites/{site-id}/microsoft.graph.getByPath(path=\'{path}\')/microsoft.graph.getActivitiesByInterval(startDateTime=\'{startDateTime}\',endDateTime=\'{endDateTime}\',interval=\'{interval}\')'].get
  update:
    x-apievangelist-phrasing:
      intent: Get activity for a group site path over a date range
      effect: read
      questions:
      - How much activity did a group site path see between two dates, broken down by day or week?
      - Can I choose the start date, end date and interval for site activity stats?
      instructions:
      - text: Get {interval} activity for path {path} on site {site} of group {group} from {start} to {end}.
        slots:
          interval: path.interval
          path: path.path
          site: path.site-id
          group: path.group-id
          start: path.startDateTime
          end: path.endDateTime
      - text: Show activity between {start} and {end} grouped by {interval} for site path {path} in group {group} site {site}.
        slots:
          start: path.startDateTime
          end: path.endDateTime
          interval: path.interval
          path: path.path
          group: path.group-id
          site: path.site-id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/{group-id}/sites/{site-id}/microsoft.graph.getByPath(path=\'{path}\')/microsoft.graph.getApplicableContentTypesForList(listId=\'{listId}\')'].get
  update:
    x-apievangelist-phrasing:
      intent: List content types addable to a group site list
      effect: read
      questions:
      - Which site content types can I add to a particular list on a group's SharePoint site?
      - Can I see the content types applicable to a list, reached by site path?
      instructions:
      - text: List content types applicable to list {listId} at path {path} on site {site} of group {group}.
        slots:
          listId: path.listId
          path: path.path
          site: path.site-id
          group: path.group-id
      - text: Show which content types can be added to list {listId} in group {group}'s site {site} path {path}.
        slots:
          listId: path.listId
          group: path.group-id
          site: path.site-id
          path: path.path
      method: generated
      generated: '2026-10-01'
- target: $.paths['/groups/microsoft.graph.delta()'].get
  update:
    x-apievangelist-phrasing:
      intent: Track changes to groups and memberships
      effect: read
      questions:
      - How can I get only the groups that were created, updated or deleted since my last sync?
      - Does the group change feed include membership changes?
      instructions:
      - text: Get incremental changes to groups, including membership changes.
      - text: Start a group delta sync selecting only {select}.
        slots:
          select: query.$select
      method: generated
      generated: '2026-10-01'