API Evangelist conversational phrasing for GitHub v3 REST Orgs 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 Orgs API
  version: 1.0.0
extends: openapi/github-orgs-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: 49
- target: $.paths['/organizations'].get
  update:
    x-apievangelist-phrasing:
      intent: List every organization on the server
      effect: read
      questions:
      - Can I get a list of all organizations on our GitHub Enterprise Server in the order they were created?
      - How do I page through every organization on the instance using an organization ID cursor?
      instructions:
      - text: List all organizations on the server, oldest first.
      - text: List the organizations created after organization ID {since}.
        slots:
          since: query.since
      method: generated
      generated: '2026-09-24'
- target: $.paths['/organizations/{organization_id}/custom_roles'].get
  update:
    x-apievangelist-phrasing:
      intent: List custom repository roles (deprecated, by org ID)
      effect: read
      questions:
      - Is there an older endpoint that lists an organization's custom repository roles by numeric organization ID?
      - What custom repository roles exist for an organization when I only know its numeric ID?
      instructions:
      - text: Use the deprecated endpoint to list custom repository roles for organization ID {organization_id}.
        slots:
          organization_id: path.organization_id
      - text: Look up the custom roles for numeric organization {organization_id} via the legacy roles endpoint.
        slots:
          organization_id: path.organization_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an organization's profile and settings
      effect: read
      questions:
      - What details can I pull about a GitHub organization, like its plan, billing email and settings?
      - Does this organization require two-factor authentication for its members?
      instructions:
      - text: Show me the profile and settings for organization {org}.
        slots:
          org: path.org
      - text: Check whether {org} requires two-factor authentication.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an organization and all its repositories
      effect: destructive
      questions:
      - What happens to the repositories when I delete a whole organization?
      - Can the organization's login name be reused right after the organization is deleted?
      instructions:
      - text: Delete the organization {org} along with all of its repositories.
        slots:
          org: path.org
      - text: Permanently remove organization {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an organization's profile and settings
      effect: write
      questions:
      - How do I change the billing email or public profile details of an organization?
      - Can I stop members from creating public repositories in my organization?
      - Is it possible to turn on secret scanning automatically for every new repository in the org?
      instructions:
      - text: Change the billing email for organization {org} to {billing_email}.
        slots:
          org: path.org
          billing_email: requestBody.billing_email
      - text: Set the default repository permission for members of {org} to {default_repository_permission}.
        slots:
          org: path.org
          default_repository_permission: requestBody.default_repository_permission
      - text: Update the organization {org} description to {description} and its location to {location}.
        slots:
          org: path.org
          description: requestBody.description
          location: requestBody.location
      - text: Require web commit sign-off for all repositories in {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/announcement'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an organization's announcement banner
      effect: read
      questions:
      - What announcement banner is currently showing to members of our organization?
      - When does the organization's current announcement banner expire?
      instructions:
      - text: Show me the announcement banner set for {org}.
        slots:
          org: path.org
      - text: Read the current org-wide announcement message for {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/announcement'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an organization's announcement banner
      effect: destructive
      questions:
      - How do I take down the announcement banner from our organization?
      - Can I clear an org announcement before it expires on its own?
      instructions:
      - text: Remove the announcement banner from {org}.
        slots:
          org: path.org
      - text: Clear the org-wide announcement for {org} now.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/announcement'].patch
  update:
    x-apievangelist-phrasing:
      intent: Set an organization's announcement banner
      effect: write
      questions:
      - Can I post a banner message that every member of my organization sees?
      - Is there a way to give an organization announcement an automatic expiry date?
      instructions:
      - text: Set the announcement banner for {org} to {announcement}.
        slots:
          org: path.org
          announcement: requestBody.announcement
      - text: Post the banner {announcement} to {org} and have it expire at {expires_at}.
        slots:
          org: path.org
          announcement: requestBody.announcement
          expires_at: requestBody.expires_at
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/audit-log'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an organization's audit log
      effect: read
      questions:
      - Who changed what in our organization over the last few months?
      - Can I search the organization audit log for older events or only Git events?
      - How far back does the organization audit log go by default?
      instructions:
      - text: Show me the audit log for {org}, newest events first.
        slots:
          org: path.org
      - text: Search the audit log of {org} for {phrase}.
        slots:
          org: path.org
          phrase: query.phrase
      - text: List {include} events from the {org} audit log in {order} order.
        slots:
          org: path.org
          include: query.include
          order: query.order
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/custom-repository-roles'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's custom repository roles
      effect: read
      questions:
      - Which custom repository roles has my organization defined?
      - What custom roles can I assign to people on repositories in this org?
      instructions:
      - text: List the custom repository roles defined in {org}.
        slots:
          org: path.org
      - text: Show every custom repo role available in organization {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/custom-repository-roles'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a custom repository role
      effect: write
      questions:
      - Can I create a new repository role that builds on Write access but adds a few extra permissions?
      - How do I define a custom role for repositories in my organization?
      instructions:
      - text: Create a custom repository role named {name} in {org} based on {base_role} with permissions {permissions}.
        slots:
          org: path.org
          name: requestBody.name
          base_role: requestBody.base_role
          permissions: requestBody.permissions
      - text: Add a new repo role {name} to {org}, described as {description}, inheriting from {base_role} plus {permissions}.
        slots:
          org: path.org
          name: requestBody.name
          description: requestBody.description
          base_role: requestBody.base_role
          permissions: requestBody.permissions
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/custom-repository-roles/{role_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one custom repository role
      effect: read
      questions:
      - Which permissions and base role does a specific custom repository role grant?
      - What exactly is in one of our organization's custom repo roles?
      instructions:
      - text: Show me custom repository role {role_id} in {org}.
        slots:
          org: path.org
          role_id: path.role_id
      - text: Get the permissions granted by role {role_id} in organization {org}.
        slots:
          org: path.org
          role_id: path.role_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/custom-repository-roles/{role_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a custom repository role
      effect: destructive
      questions:
      - Can I get rid of a custom repository role we no longer use?
      - What happens when I delete a custom repo role from the organization?
      instructions:
      - text: Delete custom repository role {role_id} from {org}.
        slots:
          org: path.org
          role_id: path.role_id
      - text: Remove the custom repo role {role_id} in organization {org}.
        slots:
          org: path.org
          role_id: path.role_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/custom-repository-roles/{role_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a custom repository role
      effect: write
      questions:
      - Can I add permissions to a custom repository role that already exists?
      - Is it possible to rename an existing custom repo role or change its base role?
      instructions:
      - text: Rename existing custom role {role_id} in {org} to {name}.
        slots:
          org: path.org
          role_id: path.role_id
          name: requestBody.name
      - text: Change the permissions on existing role {role_id} in {org} to {permissions}.
        slots:
          org: path.org
          role_id: path.role_id
          permissions: requestBody.permissions
      - text: Switch the base role of custom role {role_id} in {org} to {base_role}.
        slots:
          org: path.org
          role_id: path.role_id
          base_role: requestBody.base_role
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/hooks'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's webhooks
      effect: read
      questions:
      - Which webhooks are configured at the organization level?
      - What org webhooks are sending events out of our organization right now?
      instructions:
      - text: List all webhooks on organization {org}.
        slots:
          org: path.org
      - text: Show me the organization-level hooks for {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/hooks'].post
  update:
    x-apievangelist-phrasing:
      intent: Create an organization webhook
      effect: write
      questions:
      - How do I get notified at my own URL whenever something happens across my organization?
      - Can one org webhook subscribe to just a few event types?
      instructions:
      - text: Create a {name} webhook on {org} with configuration {config}.
        slots:
          org: path.org
          name: requestBody.name
          config: requestBody.config
      - text: Add a new webhook to {org} with config {config} that fires on {events}.
        slots:
          org: path.org
          config: requestBody.config
          events: requestBody.events
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/hooks/{hook_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an organization webhook
      effect: read
      questions:
      - Which events is a specific organization webhook subscribed to, and is it active?
      - Can I look at the details of one webhook on my org?
      instructions:
      - text: Show me webhook {hook_id} on {org}.
        slots:
          org: path.org
          hook_id: path.hook_id
      - text: Get the events and active status of org hook {hook_id} in {org}.
        slots:
          org: path.org
          hook_id: path.hook_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/hooks/{hook_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an organization webhook
      effect: destructive
      questions:
      - How do I stop an organization webhook from sending events for good?
      - Can I delete an org-level webhook without touching the repository webhooks?
      instructions:
      - text: Delete webhook {hook_id} from {org}.
        slots:
          org: path.org
          hook_id: path.hook_id
      - text: Remove the organization hook {hook_id} in {org} entirely.
        slots:
          org: path.org
          hook_id: path.hook_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/hooks/{hook_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an organization webhook's events or status
      effect: write
      questions:
      - Can I pause an organization webhook without deleting it?
      - How do I change which events an existing org webhook listens for?
      instructions:
      - text: Deactivate org webhook {hook_id} in {org} by setting active to {active}.
        slots:
          org: path.org
          hook_id: path.hook_id
          active: requestBody.active
      - text: Change existing hook {hook_id} on {org} to fire on {events}.
        slots:
          org: path.org
          hook_id: path.hook_id
          events: requestBody.events
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/hooks/{hook_id}/config'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an organization webhook's delivery configuration
      effect: read
      questions:
      - What URL and content type is an org webhook delivering to?
      - Is SSL verification turned off on one of our organization webhooks?
      instructions:
      - text: Show the delivery URL and content type configured for hook {hook_id} on {org}.
        slots:
          org: path.org
          hook_id: path.hook_id
      - text: Check the SSL setting in the config of org webhook {hook_id} for {org}.
        slots:
          org: path.org
          hook_id: path.hook_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/hooks/{hook_id}/config'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update an organization webhook's URL, secret or SSL
      effect: write
      questions:
      - How do I point an existing org webhook at a new URL?
      - Can I rotate the secret on an organization webhook without recreating it?
      instructions:
      - text: Point org webhook {hook_id} in {org} at {url}.
        slots:
          org: path.org
          hook_id: path.hook_id
          url: requestBody.url
      - text: Rotate the secret on org hook {hook_id} in {org} to {secret}.
        slots:
          org: path.org
          hook_id: path.hook_id
          secret: requestBody.secret
      - text: Set the payload content type for hook {hook_id} on {org} to {content_type}.
        slots:
          org: path.org
          hook_id: path.hook_id
          content_type: requestBody.content_type
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/hooks/{hook_id}/deliveries'].get
  update:
    x-apievangelist-phrasing:
      intent: List deliveries for an organization webhook
      effect: read
      questions:
      - Did our organization webhook actually deliver its recent events?
      - Can I see only the redelivery attempts for an org webhook?
      instructions:
      - text: List recent deliveries for webhook {hook_id} on {org}.
        slots:
          org: path.org
          hook_id: path.hook_id
      - text: Show only redelivered attempts for org hook {hook_id} in {org} with redelivery {redelivery}.
        slots:
          org: path.org
          hook_id: path.hook_id
          redelivery: query.redelivery
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/hooks/{hook_id}/deliveries/{delivery_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one delivery of an organization webhook
      effect: read
      questions:
      - What request and response were recorded for one specific org webhook delivery?
      - Why did a single organization webhook delivery fail?
      instructions:
      - text: Show delivery {delivery_id} for webhook {hook_id} on {org}.
        slots:
          org: path.org
          hook_id: path.hook_id
          delivery_id: path.delivery_id
      - text: Get the request and response details of org hook delivery {delivery_id} ({hook_id}, {org}).
        slots:
          org: path.org
          hook_id: path.hook_id
          delivery_id: path.delivery_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/hooks/{hook_id}/deliveries/{delivery_id}/attempts'].post
  update:
    x-apievangelist-phrasing:
      intent: Redeliver an organization webhook delivery
      effect: write
      questions:
      - Can I resend a webhook event that my server failed to receive from the org?
      - How do I retry one failed organization webhook delivery?
      instructions:
      - text: Redeliver delivery {delivery_id} of webhook {hook_id} on {org}.
        slots:
          org: path.org
          hook_id: path.hook_id
          delivery_id: path.delivery_id
      - text: Retry the failed org webhook delivery {delivery_id} for hook {hook_id} in {org}.
        slots:
          org: path.org
          hook_id: path.hook_id
          delivery_id: path.delivery_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/hooks/{hook_id}/pings'].post
  update:
    x-apievangelist-phrasing:
      intent: Ping an organization webhook
      effect: write
      questions:
      - Is there a way to send a test ping to an organization webhook?
      - Can I check that my org webhook endpoint is reachable without waiting for a real event?
      instructions:
      - text: Send a ping event to webhook {hook_id} on {org}.
        slots:
          org: path.org
          hook_id: path.hook_id
      - text: Test org hook {hook_id} in {org} with a ping.
        slots:
          org: path.org
          hook_id: path.hook_id
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/installations'].get
  update:
    x-apievangelist-phrasing:
      intent: List GitHub App installations in an organization
      effect: read
      questions:
      - Which GitHub Apps are installed on our organization?
      - What apps have been granted access to our org account?
      instructions:
      - text: List the GitHub App installations for {org}.
        slots:
          org: path.org
      - text: Show every app installed on organization {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/members'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's members
      effect: read
      questions:
      - Who are all the members of our organization, including concealed ones?
      - Which organization members still don't have two-factor authentication turned on?
      - Can I list only the admins of an organization?
      instructions:
      - text: List all members of {org}.
        slots:
          org: path.org
      - text: List members of {org} matching filter {filter}, such as those with 2FA disabled.
        slots:
          org: path.org
          filter: query.filter
      - text: Show the members of {org} who have the {role} role.
        slots:
          org: path.org
          role: query.role
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/members/{username}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check whether a user is an organization member
      effect: read
      questions:
      - Is a particular user a member of my organization, public or concealed?
      - Can I confirm someone belongs to an org with a simple yes or no?
      instructions:
      - text: Check whether {username} is a member of {org}.
        slots:
          org: path.org
          username: path.username
      - text: Confirm that user {username} belongs to organization {org}.
        slots:
          org: path.org
          username: path.username
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/members/{username}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a member from an organization
      effect: destructive
      questions:
      - What happens to someone's team memberships and repository access when I kick them out of the organization?
      - Can I remove a person from the org entirely, not just from a team?
      instructions:
      - text: Remove {username} from organization {org}.
        slots:
          org: path.org
          username: path.username
      - text: Kick member {username} out of {org} and revoke their access.
        slots:
          org: path.org
          username: path.username
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/memberships/{username}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a user's membership role and state in an org
      effect: read
      questions:
      - Is a user an admin or a regular member of our organization, and is their invitation still pending?
      - What role does a specific person hold in the org?
      instructions:
      - text: Get the membership role and state of {username} in {org}.
        slots:
          org: path.org
          username: path.username
      - text: Tell me whether {username} is pending or active in {org} and what role they have.
        slots:
          org: path.org
          username: path.username
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/memberships/{username}'].put
  update:
    x-apievangelist-phrasing:
      intent: Invite a user or change their organization role
      effect: write
      questions:
      - How do I invite someone to join my organization?
      - Can I promote an existing member to organization owner?
      instructions:
      - text: Invite {username} to join {org}.
        slots:
          org: path.org
          username: path.username
      - text: Set the role of {username} in {org} to {role}.
        slots:
          org: path.org
          username: path.username
          role: requestBody.role
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/memberships/{username}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a user's membership or cancel their invitation
      effect: destructive
      questions:
      - Can I cancel a pending invitation someone hasn't accepted yet?
      - How do I revoke a user's organization membership record, invited or active?
      instructions:
      - text: Cancel the pending organization invitation for {username} in {org}.
        slots:
          org: path.org
          username: path.username
      - text: Revoke the membership record of {username} in {org}.
        slots:
          org: path.org
          username: path.username
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/outside_collaborators'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's outside collaborators
      effect: read
      questions:
      - Who has access to our repositories without being an organization member?
      - Which outside collaborators have two-factor authentication disabled?
      instructions:
      - text: List the outside collaborators for {org}.
        slots:
          org: path.org
      - text: Show outside collaborators of {org} matching filter {filter}.
        slots:
          org: path.org
          filter: query.filter
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/outside_collaborators/{username}'].put
  update:
    x-apievangelist-phrasing:
      intent: Convert a member to an outside collaborator
      effect: write
      questions:
      - Can I downgrade a member to an outside collaborator so they keep only their current repository access?
      - Is it possible to run the member-to-collaborator conversion as a background job?
      instructions:
      - text: Convert {username} in {org} from a member to an outside collaborator.
        slots:
          org: path.org
          username: path.username
      - text: Turn member {username} of {org} into an outside collaborator, running it async {async}.
        slots:
          org: path.org
          username: path.username
          async: requestBody.async
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/outside_collaborators/{username}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an outside collaborator from an organization
      effect: destructive
      questions:
      - How do I cut off an outside collaborator from every repository in the organization at once?
      - Can I remove a non-member contractor from all our org repos?
      instructions:
      - text: Remove outside collaborator {username} from all repositories in {org}.
        slots:
          org: path.org
          username: path.username
      - text: Revoke contractor {username}'s outside-collaborator access to {org}.
        slots:
          org: path.org
          username: path.username
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/public_members'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's public members
      effect: read
      questions:
      - Which members have chosen to show their membership publicly on the org profile?
      - Who is publicly listed as belonging to this organization?
      instructions:
      - text: List the public members of {org}.
        slots:
          org: path.org
      - text: Show who publicly displays membership in {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/public_members/{username}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check whether a user's org membership is public
      effect: read
      questions:
      - Has a specific user made their membership in the organization public?
      - Does someone's profile publicly show that they belong to this org?
      instructions:
      - text: Check whether {username} publicly shows membership in {org}.
        slots:
          org: path.org
          username: path.username
      - text: Confirm {username} is a public member of {org}.
        slots:
          org: path.org
          username: path.username
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/public_members/{username}'].put
  update:
    x-apievangelist-phrasing:
      intent: Make my organization membership public
      effect: write
      questions:
      - Can I show on my profile that I belong to an organization?
      - How do I publicize my own membership in an org?
      instructions:
      - text: Make my membership in {org} public for user {username}.
        slots:
          org: path.org
          username: path.username
      - text: Publicize that {username} belongs to {org}.
        slots:
          org: path.org
          username: path.username
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/public_members/{username}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Hide my organization membership
      effect: destructive
      questions:
      - Can I conceal my membership in an organization so it no longer shows on my profile?
      - How do I make my own org membership private again?
      instructions:
      - text: Conceal my membership in {org} for user {username}.
        slots:
          org: path.org
          username: path.username
      - text: Hide the fact that {username} is a member of {org}.
        slots:
          org: path.org
          username: path.username
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/repository-fine-grained-permissions'].get
  update:
    x-apievangelist-phrasing:
      intent: List permissions available for custom repo roles
      effect: read
      questions:
      - Which fine-grained permissions can I add to a custom repository role?
      - What individual permissions are available when building repo roles in my organization?
      instructions:
      - text: List the fine-grained repository permissions available in {org}.
        slots:
          org: path.org
      - text: Show which permissions {org} can use when defining custom repo roles.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/security-managers'].get
  update:
    x-apievangelist-phrasing:
      intent: List an organization's security manager teams
      effect: read
      questions:
      - Which teams have the security manager role in our organization?
      - Who can manage security alerts across every repository in the org?
      instructions:
      - text: List the security manager teams for {org}.
        slots:
          org: path.org
      - text: Show which teams hold the security manager role in {org}.
        slots:
          org: path.org
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/security-managers/teams/{team_slug}'].put
  update:
    x-apievangelist-phrasing:
      intent: Grant a team the security manager role
      effect: write
      questions:
      - Can I give my security team access to manage alerts across all organization repositories?
      - How do I make a team a security manager for the org?
      instructions:
      - text: Make team {team_slug} a security manager in {org}.
        slots:
          org: path.org
          team_slug: path.team_slug
      - text: Grant the security manager role to {team_slug} in organization {org}.
        slots:
          org: path.org
          team_slug: path.team_slug
      method: generated
      generated: '2026-09-24'
- target: $.paths['/orgs/{org}/security-managers/teams/{team_slug}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Revoke a team's security manager role
      effect: destructive
      questions:
      - How do I take the security manager role away from a team?
      - Can I stop a team from managing security alerts org-wide?
      instructions:
      - text: Remove team {team_slug} from the security managers of {org}.
        slots:
          org: path.org
          team_slug: path.team_slug
      - text: Revoke security manager rights for {team_slug} in {org}.
        slots:
          org: path.org
          team_slug: path.team_slug
      method: generated
      generated: '2026-09-24'


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