# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure DeveloperHubServiceClient Git Hub O Auth API
  version: 1.0.0
extends: openapi/microsoft-azure-githuboauth-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: 3
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DevHub/locations/{location}/githuboauth/default/getGitHubOAuthInfo'].post
  update:
    x-apievangelist-phrasing:
      intent: Get GitHub OAuth info for Developer Hub
      effect: read
      questions:
      - What do I need to authenticate users with the Developer Hub GitHub app?
      - Can I supply my own redirect URL for the Developer Hub GitHub OAuth flow?
      instructions:
      - text: Get the Developer Hub GitHub OAuth info for location {location}.
        slots:
          location: path.location
      - text: Get GitHub OAuth details in {location} that redirect to {redirectUrl}.
        slots:
          location: path.location
          redirectUrl: requestBody.redirectUrl
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DevHub/locations/{location}/githuboauth/default'].get
  update:
    x-apievangelist-phrasing:
      intent: Complete the Developer Hub GitHub OAuth callback
      effect: write
      questions:
      - After authorizing the GitHub app, how does Developer Hub store my OAuth token?
      - Which values from GitHub does the Developer Hub callback need?
      instructions:
      - text: Complete the GitHub OAuth callback in {location} with code {code} and state {state}.
        slots:
          location: path.location
          code: query.code
          state: query.state
      - text: Store my GitHub token for Developer Hub using authorization code {code} and state {state}.
        slots:
          code: query.code
          state: query.state
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.DevHub/locations/{location}/githuboauth'].get
  update:
    x-apievangelist-phrasing:
      intent: List stored GitHub OAuth connections
      effect: read
      questions:
      - Has Developer Hub already stored a GitHub OAuth token for me?
      - Can I see the GitHub OAuth records Developer Hub keeps in this location?
      instructions:
      - text: List my stored Developer Hub GitHub OAuth connections in {location}.
        slots:
          location: path.location
      - text: Show the GitHub OAuth entries Developer Hub saved for region {location}.
        slots:
          location: path.location
      method: generated
      generated: '2026-10-01'