# 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 O Auth Providers API
  version: 1.0.0
extends: openapi/microsoft-azure-oauth-providers-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: 6
- target: $.paths['/oauth/providers'].get
  update:
    x-apievangelist-phrasing:
      intent: List OAuth providers in Data Manager for Agriculture
      effect: read
      questions:
      - Which OAuth providers are configured in my Data Manager for Agriculture instance?
      - Can I filter OAuth providers by name or by when they were last modified?
      instructions:
      - text: List OAuth providers named {names}.
        slots:
          names: query.names
      - text: List OAuth providers modified since {min_modified}.
        slots:
          min_modified: query.minLastModifiedDateTime
      method: generated
      generated: '2026-10-01'
- target: $.paths['/oauth/providers/{oauthProviderId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an OAuth provider
      effect: read
      questions:
      - How do I view the configuration of one OAuth provider?
      - Is a given OAuth provider set up as a production app?
      instructions:
      - text: Get OAuth provider {oauth_provider_id}.
        slots:
          oauth_provider_id: path.oauthProviderId
      - text: Show the app settings of OAuth provider {oauth_provider_id}.
        slots:
          oauth_provider_id: path.oauthProviderId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/oauth/providers/{oauthProviderId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete an OAuth provider
      effect: destructive
      questions:
      - How do I remove an OAuth provider directly, without a cascade job?
      - Can I delete one OAuth provider configuration by ID?
      instructions:
      - text: Delete OAuth provider {oauth_provider_id}.
        slots:
          oauth_provider_id: path.oauthProviderId
      - text: Remove only the OAuth provider record {oauth_provider_id}.
        slots:
          oauth_provider_id: path.oauthProviderId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/oauth/providers/{oauthProviderId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Create or update an OAuth provider
      effect: write
      questions:
      - How do I register an OAuth provider with its app ID and secret?
      - Can I switch an existing OAuth provider to a production app?
      instructions:
      - text: Create OAuth provider {oauth_provider_id} with app ID {app_id} and app secret {app_secret}.
        slots:
          oauth_provider_id: path.oauthProviderId
          app_id: requestBody.appId
          app_secret: requestBody.appSecret
      - text: Set production app to {is_production} on OAuth provider {oauth_provider_id}.
        slots:
          is_production: requestBody.isProductionApp
          oauth_provider_id: path.oauthProviderId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/oauth/providers/cascade-delete/{jobId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check an OAuth provider cascade delete job
      effect: read
      questions:
      - How do I see whether the cascade delete of an OAuth provider has finished?
      - What is the status of an OAuth provider deletion job?
      instructions:
      - text: Get OAuth provider cascade delete job {job_id}.
        slots:
          job_id: path.jobId
      - text: Check progress of OAuth provider deletion job {job_id}.
        slots:
          job_id: path.jobId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/oauth/providers/cascade-delete/{jobId}'].put
  update:
    x-apievangelist-phrasing:
      intent: Cascade delete an OAuth provider
      effect: destructive
      questions:
      - How do I delete an OAuth provider along with everything that depends on it?
      - Can I run an OAuth provider removal as a trackable background job?
      instructions:
      - text: Start cascade delete job {job_id} for OAuth provider {oauth_provider_id}.
        slots:
          job_id: path.jobId
          oauth_provider_id: query.oauthProviderId
      - text: Remove OAuth provider {oauth_provider_id} and its dependents as job {job_id}.
        slots:
          oauth_provider_id: query.oauthProviderId
          job_id: path.jobId
      method: generated
      generated: '2026-10-01'