# 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 Microsoft.Support File Workspaces API
  version: 1.0.0
extends: openapi/microsoft-azure-fileworkspaces-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Support/fileWorkspaces/{fileWorkspaceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a support file workspace in a subscription
      effect: read
      questions:
      - How do I check a file workspace I created for a support ticket in my subscription?
      - What details does a subscription-scoped support file workspace show?
      instructions:
      - text: Get support file workspace {fileWorkspaceName} in subscription {subscriptionId}.
        slots:
          fileWorkspaceName: path.fileWorkspaceName
          subscriptionId: path.subscriptionId
      - text: Show subscription file workspace {fileWorkspaceName}.
        slots:
          fileWorkspaceName: path.fileWorkspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/providers/Microsoft.Support/fileWorkspaces/{fileWorkspaceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a support file workspace in a subscription
      effect: write
      questions:
      - How do I set up a place to upload files for a support case under my subscription?
      - Can I create a support file workspace tied to a specific subscription?
      instructions:
      - text: Create support file workspace {fileWorkspaceName} in subscription {subscriptionId}.
        slots:
          fileWorkspaceName: path.fileWorkspaceName
          subscriptionId: path.subscriptionId
      - text: Make a subscription-scoped file workspace named {fileWorkspaceName}.
        slots:
          fileWorkspaceName: path.fileWorkspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Support/fileWorkspaces/{fileWorkspaceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a support file workspace without a subscription
      effect: read
      questions:
      - Can I look up a support file workspace that isn't tied to any subscription?
      - What's in a tenant-level file workspace I made for support?
      instructions:
      - text: Get the subscription-less file workspace {fileWorkspaceName}.
        slots:
          fileWorkspaceName: path.fileWorkspaceName
      - text: Show tenant-level support file workspace {fileWorkspaceName}.
        slots:
          fileWorkspaceName: path.fileWorkspaceName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Support/fileWorkspaces/{fileWorkspaceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Create a support file workspace without a subscription
      effect: write
      questions:
      - How do I create a file workspace for a support ticket when I don't have a subscription?
      - Can I make a support upload workspace at the tenant level?
      instructions:
      - text: Create a subscription-less file workspace {fileWorkspaceName}.
        slots:
          fileWorkspaceName: path.fileWorkspaceName
      - text: Set up tenant-level support file workspace {fileWorkspaceName}.
        slots:
          fileWorkspaceName: path.fileWorkspaceName
      method: generated
      generated: '2026-09-26'