# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for WebApps API Client Providers API
  version: 1.0.0
extends: openapi/microsoft-azure-functions-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: 5
- target: $.paths['/providers/Microsoft.Web/publishingUsers/web'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the publishing user
      effect: read
      questions:
      - What deployment credentials username is set for my account's FTP and local Git publishing?
      - Can I see my App Service publishing user settings?
      instructions:
      - text: Get my publishing user.
      - text: Show the account-level deployment credentials user.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/providers/Microsoft.Web/publishingUsers/web'].put
  update:
    x-apievangelist-phrasing:
      intent: Update the publishing user
      effect: write
      questions:
      - How do I change my deployment username and password for FTP or local Git?
      - Can I reset the account-level publishing credentials?
      instructions:
      - text: Update my publishing user with {properties}.
        slots:
          properties: requestBody.properties
      - text: Change the account-level deployment credentials.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/providers/Microsoft.Web/sourcecontrols'].get
  update:
    x-apievangelist-phrasing:
      intent: List available source control providers
      effect: read
      questions:
      - Which source control services can I connect my Azure websites and function apps to?
      - What source controls are linked to my account for deployments?
      instructions:
      - text: List the source controls available for my sites.
      - text: Show all source control connections on my account.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/providers/Microsoft.Web/sourcecontrols/{sourceControlType}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a source control token
      effect: read
      questions:
      - Is a token stored for a particular source control type on my account?
      - Can I check the source control token for one provider type?
      instructions:
      - text: Get the source control token for {sourceControlType}.
        slots:
          sourceControlType: path.sourceControlType
      - text: Show my stored {sourceControlType} source control credentials.
        slots:
          sourceControlType: path.sourceControlType
      method: generated
      generated: '2026-10-01'
- target: $.paths['/providers/Microsoft.Web/sourcecontrols/{sourceControlType}'].put
  update:
    x-apievangelist-phrasing:
      intent: Update a source control token
      effect: write
      questions:
      - How do I refresh the token used for deployments from a source control type?
      - Can I replace an expired source control token on my account?
      instructions:
      - text: Update the {sourceControlType} source control token with {properties}.
        slots:
          sourceControlType: path.sourceControlType
          properties: requestBody.properties
      - text: Refresh the stored token for source control type {sourceControlType}.
        slots:
          sourceControlType: path.sourceControlType
      method: generated
      generated: '2026-10-01'