API Evangelist conversational phrasing for GitHub v3 REST Enterprise Admin API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for GitHub v3 REST Enterprise Admin API
  version: 1.0.0
extends: openapi/github-enterprise-admin-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-24'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 121
- target: $.paths['/admin/hooks'].get
  update:
    x-apievangelist-phrasing:
      intent: List global webhooks on the instance
      effect: read
      questions:
      - Which global webhooks are configured on our GitHub Enterprise Server instance?
      - Can I page through all the instance-wide webhooks an admin has set up?
      instructions:
      - text: List all the global webhooks on this instance.
      - text: Show page {page} of global webhooks, {per_page} per page.
        slots:
          page: query.page
          per_page: query.per_page
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/hooks'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a global webhook
      effect: write
      questions:
      - How do I set up an instance-wide webhook that fires on user and organization events?
      - Can I create a global webhook that starts out inactive?
      instructions:
      - text: Create a global webhook named {name} with the config {config}.
        slots:
          name: requestBody.name
          config: requestBody.config
      - text: Add a new global webhook {name} using {config} that fires on {events}.
        slots:
          name: requestBody.name
          config: requestBody.config
          events: requestBody.events
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/hooks/{hook_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a global webhook's details
      effect: read
      questions:
      - What events and delivery URL is a particular global webhook configured with?
      - Is a specific instance-level webhook currently active?
      instructions:
      - text: Get global webhook {hook_id}.
        slots:
          hook_id: path.hook_id
      - text: Show the config and events for global hook {hook_id}.
        slots:
          hook_id: path.hook_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/hooks/{hook_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a global webhook
      effect: destructive
      questions:
      - How do I remove an instance-wide webhook we no longer use?
      - Can I permanently delete a global webhook from the enterprise server?
      instructions:
      - text: Delete global webhook {hook_id}.
        slots:
          hook_id: path.hook_id
      - text: Remove the instance-level webhook with ID {hook_id}.
        slots:
          hook_id: path.hook_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/hooks/{hook_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a global webhook
      effect: write
      questions:
      - How do I change which events an existing global webhook listens to?
      - Will fields I leave out reset to defaults when I edit a global webhook?
      instructions:
      - text: Update global webhook {hook_id} to fire on {events}.
        slots:
          hook_id: path.hook_id
          events: requestBody.events
      - text: Change the config of existing global hook {hook_id} to {config} and set active to {active}.
        slots:
          hook_id: path.hook_id
          config: requestBody.config
          active: requestBody.active
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/hooks/{hook_id}/pings'].post
  update:
    x-apievangelist-phrasing:
      intent: Send a test ping to a global webhook
      effect: write
      questions:
      - How can I test that a global webhook's endpoint is receiving deliveries?
      - Can I trigger a ping event for an instance-wide webhook?
      instructions:
      - text: Ping global webhook {hook_id}.
        slots:
          hook_id: path.hook_id
      - text: Send a test ping event to global hook {hook_id} to confirm delivery works.
        slots:
          hook_id: path.hook_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/keys'].get
  update:
    x-apievangelist-phrasing:
      intent: List SSH public keys across the instance
      effect: read
      questions:
      - Which user SSH public keys exist on our enterprise instance?
      - Can I see only the public keys that have been used since a certain date?
      instructions:
      - text: List all public keys on the instance.
      - text: Show public keys accessed since {since}, sorted by {sort}.
        slots:
          since: query.since
          sort: query.sort
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/keys/{key_ids}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a user's SSH public key
      effect: destructive
      questions:
      - As a site admin, how do I revoke a compromised SSH public key for a user?
      - Can I remove a public key from the instance by its key ID?
      instructions:
      - text: Delete public key {key_ids}.
        slots:
          key_ids: path.key_ids
      - text: Revoke the SSH public key with ID {key_ids} from the instance.
        slots:
          key_ids: path.key_ids
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/ldap/teams/{team_id}/mapping'].patch
  update:
    x-apievangelist-phrasing:
      intent: Map a team to an LDAP group
      effect: write
      questions:
      - How do I link an existing team to an LDAP group's distinguished name?
      - Does LDAP sync need to be enabled before I can map a team to an LDAP entry?
      instructions:
      - text: Map team {team_id} to the LDAP DN {ldap_dn}.
        slots:
          team_id: path.team_id
          ldap_dn: requestBody.ldap_dn
      - text: Change the LDAP group mapping for team {team_id} to {ldap_dn}.
        slots:
          team_id: path.team_id
          ldap_dn: requestBody.ldap_dn
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/ldap/teams/{team_id}/sync'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue an LDAP sync for a team
      effect: write
      questions:
      - How do I force a team's membership to resync from LDAP?
      - Does queuing a team LDAP sync run it immediately?
      instructions:
      - text: Queue an LDAP sync for team {team_id}.
        slots:
          team_id: path.team_id
      - text: Resync team {team_id}'s membership from its mapped LDAP group.
        slots:
          team_id: path.team_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/ldap/users/{username}/mapping'].patch
  update:
    x-apievangelist-phrasing:
      intent: Map a user to an LDAP entry
      effect: write
      questions:
      - How do I point a user account at a different LDAP distinguished name?
      - Can I fix a user's LDAP DN mapping after their directory entry moved?
      instructions:
      - text: Map user {username} to the LDAP DN {ldap_dn}.
        slots:
          username: path.username
          ldap_dn: requestBody.ldap_dn
      - text: Update the LDAP entry that {username} is linked to so it's {ldap_dn}.
        slots:
          username: path.username
          ldap_dn: requestBody.ldap_dn
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/ldap/users/{username}/sync'].post
  update:
    x-apievangelist-phrasing:
      intent: Queue an LDAP sync for a user
      effect: write
      questions:
      - How do I refresh a single user's account details from LDAP?
      - Is a user LDAP sync performed right away or queued?
      instructions:
      - text: Queue an LDAP sync for user {username}.
        slots:
          username: path.username
      - text: Resync {username}'s account from the directory.
        slots:
          username: path.username
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/organizations'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an organization as site admin
      effect: write
      questions:
      - How does a site administrator create a new organization and assign its admin?
      - Can I give a new organization a display name separate from its login?
      instructions:
      - text: Create organization {login} with {admin} as its admin.
        slots:
          login: requestBody.login
          admin: requestBody.admin
      - text: Set up a new org {login} administered by {admin} and display it as {profile_name}.
        slots:
          login: requestBody.login
          admin: requestBody.admin
          profile_name: requestBody.profile_name
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/organizations/{org}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Rename an organization
      effect: write
      questions:
      - How do I change an organization's login name on the enterprise instance?
      - Can a site admin rename an existing org?
      instructions:
      - text: Rename organization {org} to {login}.
        slots:
          org: path.org
          login: requestBody.login
      - text: Change the {org} org's login to {login}.
        slots:
          org: path.org
          login: requestBody.login
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/pre-receive-environments'].get
  update:
    x-apievangelist-phrasing:
      intent: List pre-receive hook environments
      effect: read
      questions:
      - Which pre-receive environments are available to run hook scripts in?
      - Can I sort the list of pre-receive environments by name or creation date?
      instructions:
      - text: List all pre-receive environments.
      - text: Show pre-receive environments sorted by {sort} in {direction} order.
        slots:
          sort: query.sort
          direction: query.direction
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/pre-receive-environments'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a pre-receive hook environment
      effect: write
      questions:
      - How do I add a custom environment image for pre-receive hooks to run in?
      - What do I need to supply to register a new pre-receive environment tarball?
      instructions:
      - text: Create a pre-receive environment named {name} from the image at {image_url}.
        slots:
          name: requestBody.name
          image_url: requestBody.image_url
      - text: Register a new hook environment {name} using tarball {image_url}.
        slots:
          name: requestBody.name
          image_url: requestBody.image_url
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/pre-receive-environments/{pre_receive_environment_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a pre-receive environment
      effect: read
      questions:
      - What image URL and download state does a given pre-receive environment have?
      - How many hooks use a specific pre-receive environment?
      instructions:
      - text: Get pre-receive environment {pre_receive_environment_id}.
        slots:
          pre_receive_environment_id: path.pre_receive_environment_id
      - text: Show the full details of hook environment {pre_receive_environment_id}.
        slots:
          pre_receive_environment_id: path.pre_receive_environment_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/pre-receive-environments/{pre_receive_environment_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a pre-receive environment
      effect: destructive
      questions:
      - How do I delete a pre-receive environment we no longer need?
      - Why can't I delete the default environment or one that hooks still use?
      instructions:
      - text: Delete pre-receive environment {pre_receive_environment_id}.
        slots:
          pre_receive_environment_id: path.pre_receive_environment_id
      - text: Remove the unused hook environment {pre_receive_environment_id}.
        slots:
          pre_receive_environment_id: path.pre_receive_environment_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/pre-receive-environments/{pre_receive_environment_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a pre-receive environment
      effect: write
      questions:
      - How do I rename a pre-receive environment or point it at a new image URL?
      - Can I edit the default pre-receive environment?
      instructions:
      - text: Rename pre-receive environment {pre_receive_environment_id} to {name}.
        slots:
          pre_receive_environment_id: path.pre_receive_environment_id
          name: requestBody.name
      - text: Change the image URL of hook environment {pre_receive_environment_id} to {image_url}.
        slots:
          pre_receive_environment_id: path.pre_receive_environment_id
          image_url: requestBody.image_url
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/pre-receive-environments/{pre_receive_environment_id}/downloads'].post
  update:
    x-apievangelist-phrasing:
      intent: Re-download a pre-receive environment image
      effect: write
      questions:
      - How do I refresh a pre-receive environment after publishing a new tarball at its image URL?
      - Will re-downloading an environment overwrite the existing one?
      instructions:
      - text: Start a new download for pre-receive environment {pre_receive_environment_id}.
        slots:
          pre_receive_environment_id: path.pre_receive_environment_id
      - text: Trigger a fresh tarball download for hook environment {pre_receive_environment_id} from its image URL.
        slots:
          pre_receive_environment_id: path.pre_receive_environment_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/pre-receive-environments/{pre_receive_environment_id}/downloads/latest'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a pre-receive environment download
      effect: read
      questions:
      - Has the latest tarball download for my pre-receive environment finished or failed?
      - Can I check just the download state of a hook environment?
      instructions:
      - text: Get the latest download status for pre-receive environment {pre_receive_environment_id}.
        slots:
          pre_receive_environment_id: path.pre_receive_environment_id
      - text: Check whether hook environment {pre_receive_environment_id} finished downloading.
        slots:
          pre_receive_environment_id: path.pre_receive_environment_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/pre-receive-hooks'].get
  update:
    x-apievangelist-phrasing:
      intent: List all pre-receive hooks on the instance
      effect: read
      questions:
      - Which pre-receive hooks are defined globally on our enterprise server?
      - Can I sort the instance's pre-receive hooks by name?
      instructions:
      - text: List every pre-receive hook defined at the instance level.
      - text: Show instance pre-receive hooks sorted by {sort} {direction}.
        slots:
          sort: query.sort
          direction: query.direction
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/pre-receive-hooks'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a pre-receive hook
      effect: write
      questions:
      - How do I create a pre-receive hook that runs a script from a repository to block bad pushes?
      - Can I let organizations override the enforcement of a new hook?
      instructions:
      - text: Create a pre-receive hook {name} running {script} from {script_repository} in environment {environment}.
        slots:
          name: requestBody.name
          script: requestBody.script
          script_repository: requestBody.script_repository
          environment: requestBody.environment
      - text: Add hook {name} using script {script} in {script_repository} on {environment} with enforcement {enforcement}.
        slots:
          name: requestBody.name
          script: requestBody.script
          script_repository: requestBody.script_repository
          environment: requestBody.environment
          enforcement: requestBody.enforcement
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/pre-receive-hooks/{pre_receive_hook_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a pre-receive hook's instance settings
      effect: read
      questions:
      - What script and environment does a given global pre-receive hook use?
      - Is a specific pre-receive hook enforced instance-wide?
      instructions:
      - text: Get instance pre-receive hook {pre_receive_hook_id}.
        slots:
          pre_receive_hook_id: path.pre_receive_hook_id
      - text: Show the global script, environment and enforcement of hook {pre_receive_hook_id}.
        slots:
          pre_receive_hook_id: path.pre_receive_hook_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/pre-receive-hooks/{pre_receive_hook_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a pre-receive hook
      effect: destructive
      questions:
      - How do I delete a pre-receive hook entirely from the instance?
      - Can I remove a global hook definition rather than just disabling it for one org?
      instructions:
      - text: Delete pre-receive hook {pre_receive_hook_id} from the instance.
        slots:
          pre_receive_hook_id: path.pre_receive_hook_id
      - text: Permanently remove the hook definition {pre_receive_hook_id}.
        slots:
          pre_receive_hook_id: path.pre_receive_hook_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/pre-receive-hooks/{pre_receive_hook_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a pre-receive hook's global settings
      effect: write
      questions:
      - How do I change the script or environment a global pre-receive hook runs?
      - Can I stop orgs from overriding a hook by changing its downstream configuration setting?
      instructions:
      - text: Change the script of instance hook {pre_receive_hook_id} to {script}.
        slots:
          pre_receive_hook_id: path.pre_receive_hook_id
          script: requestBody.script
      - text: Set global enforcement of hook {pre_receive_hook_id} to {enforcement} and downstream configuration to {allow_downstream_configuration}.
        slots:
          pre_receive_hook_id: path.pre_receive_hook_id
          enforcement: requestBody.enforcement
          allow_downstream_configuration: requestBody.allow_downstream_configuration
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/tokens'].get
  update:
    x-apievangelist-phrasing:
      intent: List personal access tokens for all users
      effect: read
      questions:
      - Which personal access tokens exist across every user on the instance, admins included?
      - Can a site admin audit all PATs on the server?
      instructions:
      - text: List personal access tokens for all users.
      - text: Show page {page} of every user's personal access tokens.
        slots:
          page: query.page
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/tokens/{token_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a user's personal access token
      effect: destructive
      questions:
      - How do I revoke someone's personal access token as a site admin?
      - Why do I get a 403 when deleting a token I'm currently using?
      instructions:
      - text: Delete personal access token {token_id}.
        slots:
          token_id: path.token_id
      - text: Revoke the PAT with ID {token_id}.
        slots:
          token_id: path.token_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/users'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a user account
      effect: write
      questions:
      - How does a site admin create a new user account on the instance?
      - Can I create a user who starts out suspended?
      instructions:
      - text: Create user {login} with email {email}.
        slots:
          login: requestBody.login
          email: requestBody.email
      - text: Add a new account {login} and set suspended to {suspended}.
        slots:
          login: requestBody.login
          suspended: requestBody.suspended
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/users/{username}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a user and all their data
      effect: destructive
      questions:
      - What gets removed when I delete a user account from the instance?
      - Can I delete a user account instead of suspending it?
      instructions:
      - text: Delete user {username} along with their repositories and gists.
        slots:
          username: path.username
      - text: Permanently remove the account {username} from the instance.
        slots:
          username: path.username
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/users/{username}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Change a user's username
      effect: write
      questions:
      - How do I rename a user's login on the enterprise server?
      - Can a site admin change someone's username for them?
      instructions:
      - text: Change the username of {username} to {login}.
        slots:
          username: path.username
          login: requestBody.login
      - text: Rename user {username} so their login becomes {login}.
        slots:
          username: path.username
          login: requestBody.login
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/users/{username}/authorizations'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an impersonation token for a user
      effect: write
      questions:
      - How can a site admin get an OAuth token that acts as a specific user?
      - Which scopes can I grant on an impersonation token?
      instructions:
      - text: Create an impersonation OAuth token for {username} with scopes {scopes}.
        slots:
          username: path.username
          scopes: requestBody.scopes
      - text: Issue a token to act as {username} limited to {scopes}.
        slots:
          username: path.username
          scopes: requestBody.scopes
      method: generated
      generated: '2026-09-24'
- target: $.paths['/admin/users/{username}/authorizations'].delete
  update:
    x-apievangelist-phrasing:
      intent: Revoke a user's impersonation token
      effect: destructive
      questions:
      - How do I revoke the impersonation OAuth token I created for a user?
      - Can I clean up an impersonation token once I'm done acting as someone?
      instructions:
      - text: Delete the impersonation OAuth token for {username}.
        slots:
          username: path.username
      - text: Revoke my impersonation access to {username}.
        slots:
          username: path.username
      method: generated
      generated: '2026-09-24'
- target: $.paths['/enterprise/announcement'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the global announcement banner
      effect: read
      questions:
      - What does the enterprise-wide announcement banner currently say?
      - When does the current global announcement expire?
      instructions:
      - text: Show the current global announcement banner.
      - text: Get the announcement message and expiry date for the enterprise.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/enterprise/announcement'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove the global announcement banner
      effect: destructive
      questions:
      - How do I take down the enterprise announcement banner early?
      - Can I clear the global banner without setting a new one?
      instructions:
      - text: Remove the global announcement banner.
      - text: Clear the enterprise-wide banner message now.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/enterprise/announcement'].patch
  update:
    x-apievangelist-phrasing:
      intent: Set the global announcement banner
      effect: write
      questions:
      - How do I post a banner message to every user in our enterprise?
      - Can I make the global announcement expire automatically at a set time?
      instructions:
      - text: Set the global announcement to {announcement}.
        slots:
          announcement: requestBody.announcement
      - text: Post the banner {announcement} and have it expire at {expires_at}.
        slots:
          announcement: requestBody.announcement
          expires_at: requestBody.expires_at
      method: generated
      generated: '2026-09-24'
- target: $.paths['/enterprise/settings/license'].get
  update:
    x-apievangelist-phrasing:
      intent: Get enterprise license information
      effect: read
      questions:
      - How many seats does our GitHub Enterprise license have and how many are used?
      - When does the enterprise license expire?
      instructions:
      - text: Show the enterprise license information.
      - text: Check seat usage and expiration on our license.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/enterprise/stats/all'].get
  update:
    x-apievangelist-phrasing:
      intent: Get all instance statistics
      effect: read
      questions:
      - Where can I get one overview of every usage statistic for the instance?
      - Can I pull repos, users, issues and pull request counts in a single call?
      instructions:
      - text: Get all statistics for the instance.
      - text: Give me the full usage stats overview across every category.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/enterprise/stats/comments'].get
  update:
    x-apievangelist-phrasing:
      intent: Get comment statistics
      effect: read
      questions:
      - How many comments have been made on commits, gists, issues and pull requests?
      - What are the comment counts across the instance?
      instructions:
      - text: Get comment statistics for the instance.
      - text: Show only the comment counts.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/enterprise/stats/gists'].get
  update:
    x-apievangelist-phrasing:
      intent: Get gist statistics
      effect: read
      questions:
      - How many gists exist on the instance, and how many are private?
      - What are the gist usage numbers?
      instructions:
      - text: Get gist statistics for the instance.
      - text: Show the private and public gist counts.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/enterprise/stats/hooks'].get
  update:
    x-apievangelist-phrasing:
      intent: Get webhook statistics
      effect: read
      questions:
      - How many webhooks are configured across the instance and how many are active?
      - What are the hook usage numbers?
      instructions:
      - text: Get hook statistics for the instance.
      - text: Show the active versus inactive webhook counts.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/enterprise/stats/issues'].get
  update:
    x-apievangelist-phrasing:
      intent: Get issue statistics
      effect: read
      questions:
      - How many issues are open versus closed on the instance?
      - What are the total issue counts?
      instructions:
      - text: Get issue statistics for the instance.
      - text: Show the open and closed issue counts.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/enterprise/stats/milestones'].get
  update:
    x-apievangelist-phrasing:
      intent: Get milestone statistics
      effect: read
      questions:
      - How many milestones are open or closed across all repositories?
      - What are the milestone totals?
      instructions:
      - text: Get milestone statistics for the instance.
      - text: Show the open and closed milestone counts.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/enterprise/stats/orgs'].get
  update:
    x-apievangelist-phrasing:
      intent: Get organization statistics
      effect: read
      questions:
      - How many organizations and teams exist on the instance?
      - What are the org and team membership totals?
      instructions:
      - text: Get organization statistics for the instance.
      - text: Show the org, team and team member counts.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/enterprise/stats/pages'].get
  update:
    x-apievangelist-phrasing:
      intent: Get GitHub Pages statistics
      effect: read
      questions:
      - How many GitHub Pages sites are published on the instance?
      - What are the Pages usage numbers?
      instructions:
      - text: Get Pages statistics for the instance.
      - text: Show how many Pages sites exist.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/enterprise/stats/pulls'].get
  update:
    x-apievangelist-phrasing:
      intent: Get pull request statistics
      effect: read
      questions:
      - How many pull requests are merged, mergeable or unmergeable on the instance?
      - What are the pull request totals?
      instructions:
      - text: Get pull request statistics for the instance.
      - text: Show merged and unmergeable pull request counts.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/enterprise/stats/repos'].get
  update:
    x-apievangelist-phrasing:
      intent: Get repository statistics
      effect: read
      questions:
      - How many repositories, forks and root repos exist on the instance?
      - What are the repository totals?
      instructions:
      - text: Get repository statistics for the instance.
      - text: Show the repo, fork and org-owned repository counts.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/enterprise/stats/users'].get
  update:
    x-apievangelist-phrasing:
      intent: Get user statistics
      effect: read
      questions:
      - How many users, admins and suspended accounts are on the instance?
      - What are the user account totals?
      instructions:
      - text: Get user statistics for the instance.
      - text: Show the admin and suspended user counts.
      method: generated
      generated: '2026-09-24'
- target: $.paths['/enterprises/{enterprise}/actions/permissions'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an enterprise's Actions permissions policy
      effect: read
      questions:
      - Which organizations in my enterprise are allowed to use GitHub Actions?
      - What is our enterprise policy on which actions can run?
      instructions:
      - text: Get the GitHub Actions permissions policy for enterprise {enterprise}.
        slots:
          enterprise: path.enterprise
      - text: Show which orgs and actions are allowed under {enterprise}'s Actions policy.
        slots:
          enterprise: path.enterprise
      method: generated
      generated: '2026-09-24'


# --- truncated at 32 KB (87 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/overlays/github-enterprise-admin-api-phrasing-overlay.yaml