# 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 Test Base Test Result API
  version: 1.0.0
extends: openapi/microsoft-azure-test-result-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: 14
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/testSummaries'].get
  update:
    x-apievangelist-phrasing:
      intent: List test summaries in a Test Base account
      effect: read
      questions:
      - How do I see the test summaries for every package in my Test Base account?
      - Which packages in Test Base have passed or failed their latest runs?
      instructions:
      - text: List test summaries for Test Base account {testBaseAccountName} in {resourceGroupName}, subscription {subscriptionId}.
        slots:
          testBaseAccountName: path.testBaseAccountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show me the package test summaries in Test Base account {testBaseAccountName}.
        slots:
          testBaseAccountName: path.testBaseAccountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/testSummaries/{testSummaryName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a test summary from a Test Base account
      effect: read
      questions:
      - Can I pull one named test summary from my Test Base account?
      - What does the test summary for a particular package show?
      instructions:
      - text: Get test summary {testSummaryName} in Test Base account {testBaseAccountName} ({resourceGroupName}, sub {subscriptionId}).
        slots:
          testSummaryName: path.testSummaryName
          testBaseAccountName: path.testBaseAccountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show test summary {testSummaryName} from account {testBaseAccountName}.
        slots:
          testSummaryName: path.testSummaryName
          testBaseAccountName: path.testBaseAccountName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/packages/{packageName}/testResults'].get
  update:
    x-apievangelist-phrasing:
      intent: List test results for a Test Base package
      effect: read
      questions:
      - What test results exist for my package on security or feature OS updates?
      - Can I filter a package's test results by OS name, release or build version?
      instructions:
      - text: List {osUpdateType} test results for package {packageName} in Test Base account {testBaseAccountName} ({resourceGroupName}, sub {subscriptionId}).
        slots:
          osUpdateType: query.osUpdateType
          packageName: path.packageName
          testBaseAccountName: path.testBaseAccountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show test results for package {packageName} filtered by {filter}, OS update type {osUpdateType}, account {testBaseAccountName}, group {resourceGroupName}.
        slots:
          packageName: path.packageName
          filter: query.$filter
          osUpdateType: query.osUpdateType
          testBaseAccountName: path.testBaseAccountName
          resourceGroupName: path.resourceGroupName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/packages/{packageName}/testResults/{testResultName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a test result for a Test Base package
      effect: read
      questions:
      - How do I look up one specific test result of a Test Base package?
      - What were the details of a particular test run for my package?
      instructions:
      - text: Get test result {testResultName} for package {packageName} in {testBaseAccountName} ({resourceGroupName}, sub {subscriptionId}).
        slots:
          testResultName: path.testResultName
          packageName: path.packageName
          testBaseAccountName: path.testBaseAccountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show test run {testResultName} of Test Base package {packageName}.
        slots:
          testResultName: path.testResultName
          packageName: path.packageName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/packages/{packageName}/osUpdates'].get
  update:
    x-apievangelist-phrasing:
      intent: List OS updates a package was tested on
      effect: read
      questions:
      - Which OS updates has my Test Base package already been tested against?
      - Can I see only the feature updates or security updates my package ran on?
      instructions:
      - text: List {osUpdateType} OS updates package {packageName} was tested on in {testBaseAccountName} ({resourceGroupName}, sub {subscriptionId}).
        slots:
          osUpdateType: query.osUpdateType
          packageName: path.packageName
          testBaseAccountName: path.testBaseAccountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the OS updates tested for Test Base package {packageName}.
        slots:
          packageName: path.packageName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/packages/{packageName}/osUpdates/{osUpdateResourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an OS update a package was tested on
      effect: read
      questions:
      - How do I get the details of one OS update my package was tested with?
      - What build and release info is recorded for a tested OS update?
      instructions:
      - text: Get OS update {osUpdateResourceName} for package {packageName} in {testBaseAccountName} ({resourceGroupName}, sub {subscriptionId}).
        slots:
          osUpdateResourceName: path.osUpdateResourceName
          packageName: path.packageName
          testBaseAccountName: path.testBaseAccountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show tested OS update {osUpdateResourceName} of package {packageName}.
        slots:
          osUpdateResourceName: path.osUpdateResourceName
          packageName: path.packageName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/packages/{packageName}/favoriteProcesses'].get
  update:
    x-apievangelist-phrasing:
      intent: List favorite processes for a Test Base package
      effect: read
      questions:
      - Which processes have I marked as favorites for my Test Base package?
      - What processes am I tracking as favorites in package analysis?
      instructions:
      - text: List favorite processes for package {packageName} in Test Base account {testBaseAccountName} ({resourceGroupName}, sub {subscriptionId}).
        slots:
          packageName: path.packageName
          testBaseAccountName: path.testBaseAccountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show all favorite processes on Test Base package {packageName}.
        slots:
          packageName: path.packageName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/packages/{packageName}/favoriteProcesses/{favoriteProcessResourceName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a favorite process of a Test Base package
      effect: read
      questions:
      - Can I look up one favorite process on a Test Base package?
      - What actual process name is stored for a given favorite process?
      instructions:
      - text: Get favorite process {favoriteProcessResourceName} for package {packageName} in {testBaseAccountName} ({resourceGroupName}, sub {subscriptionId}).
        slots:
          favoriteProcessResourceName: path.favoriteProcessResourceName
          packageName: path.packageName
          testBaseAccountName: path.testBaseAccountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show favorite process {favoriteProcessResourceName} on package {packageName}.
        slots:
          favoriteProcessResourceName: path.favoriteProcessResourceName
          packageName: path.packageName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/packages/{packageName}/favoriteProcesses/{favoriteProcessResourceName}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add or replace a favorite process on a package
      effect: write
      questions:
      - How do I mark a process as a favorite for a Test Base package?
      - Can I replace an existing favorite process with a different executable?
      instructions:
      - text: Add favorite process {favoriteProcessResourceName} to package {packageName} in {testBaseAccountName} ({resourceGroupName}, sub {subscriptionId}).
        slots:
          favoriteProcessResourceName: path.favoriteProcessResourceName
          packageName: path.packageName
          testBaseAccountName: path.testBaseAccountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Set favorite process {favoriteProcessResourceName} on package {packageName} with properties {properties}.
        slots:
          favoriteProcessResourceName: path.favoriteProcessResourceName
          packageName: path.packageName
          properties: requestBody.properties
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/packages/{packageName}/favoriteProcesses/{favoriteProcessResourceName}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a favorite process from a package
      effect: destructive
      questions:
      - How do I stop tracking a favorite process on a Test Base package?
      - Can I delete a favorite process I no longer care about?
      instructions:
      - text: Delete favorite process {favoriteProcessResourceName} from package {packageName} in {testBaseAccountName} ({resourceGroupName}, sub {subscriptionId}).
        slots:
          favoriteProcessResourceName: path.favoriteProcessResourceName
          packageName: path.packageName
          testBaseAccountName: path.testBaseAccountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Remove {favoriteProcessResourceName} from the favorite processes of package {packageName}.
        slots:
          favoriteProcessResourceName: path.favoriteProcessResourceName
          packageName: path.packageName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/packages/{packageName}/testResults/{testResultName}/analysisResults'].get
  update:
    x-apievangelist-phrasing:
      intent: List analysis results of a test result
      effect: read
      questions:
      - How do I see CPU, memory or reliability analysis for a Test Base test run?
      - Which analysis result types can I pull for a test result?
      instructions:
      - text: List {analysisResultType} analysis for test {testResultName}, package {packageName} in {testBaseAccountName} ({resourceGroupName}, sub {subscriptionId}).
        slots:
          analysisResultType: query.analysisResultType
          testResultName: path.testResultName
          packageName: path.packageName
          testBaseAccountName: path.testBaseAccountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show analysis for test run {testResultName} of package {packageName}, type {analysisResultType}.
        slots:
          testResultName: path.testResultName
          packageName: path.packageName
          analysisResultType: query.analysisResultType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/packages/{packageName}/testResults/{testResultName}/analysisResults/{analysisResultName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an analysis result of a test result by name
      effect: read
      questions:
      - Can I fetch one named analysis result, like memory utilization, for a test run?
      - What does a single analysis result of a Test Base test contain?
      instructions:
      - text: Get analysis {analysisResultName} of test {testResultName}, package {packageName} in {testBaseAccountName} ({resourceGroupName}, sub {subscriptionId}).
        slots:
          analysisResultName: path.analysisResultName
          testResultName: path.testResultName
          packageName: path.packageName
          testBaseAccountName: path.testBaseAccountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Show the {analysisResultName} analysis of test run {testResultName}.
        slots:
          analysisResultName: path.analysisResultName
          testResultName: path.testResultName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/packages/{packageName}/testResults/{testResultName}/getDownloadUrl'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a download link for a test result
      effect: read
      questions:
      - How do I download the log files of a Test Base test result?
      - Where can I get a download URL for my package's test output?
      instructions:
      - text: Get the download URL for test result {testResultName} of package {packageName} in {testBaseAccountName} ({resourceGroupName}, sub {subscriptionId}).
        slots:
          testResultName: path.testResultName
          packageName: path.packageName
          testBaseAccountName: path.testBaseAccountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Give me a link to download test result {testResultName}.
        slots:
          testResultName: path.testResultName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.TestBase/testBaseAccounts/{testBaseAccountName}/packages/{packageName}/testResults/{testResultName}/getVideoDownloadUrl'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a download link for a test's screen recording
      effect: read
      questions:
      - Can I watch the screen recording of a Test Base test execution?
      - How do I get the video of a test run for my package?
      instructions:
      - text: Get the screen recording URL for test run {testResultName} of package {packageName} in {testBaseAccountName} ({resourceGroupName}, sub {subscriptionId}).
        slots:
          testResultName: path.testResultName
          packageName: path.packageName
          testBaseAccountName: path.testBaseAccountName
          resourceGroupName: path.resourceGroupName
          subscriptionId: path.subscriptionId
      - text: Give me the screen recording link for test run {testResultName}.
        slots:
          testResultName: path.testResultName
      method: generated
      generated: '2026-09-26'