# 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 EducationManagementClient Students API
  version: 1.0.0
extends: openapi/microsoft-azure-students-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['/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/providers/Microsoft.Education/labs/default/students'].get
  update:
    x-apievangelist-phrasing:
      intent: List students in an Azure Education lab
      effect: read
      questions:
      - Which students are enrolled in my Azure for Education lab?
      - Can I include students who were removed from the lab in the list?
      instructions:
      - text: List students in the lab for billing account {account}, profile {profile}, invoice section {section}.
        slots:
          account: path.billingAccountName
          profile: path.billingProfileName
          section: path.invoiceSectionName
      - text: Show lab students for invoice section {section} under account {account}, profile {profile}, including deleted {deleted}.
        slots:
          section: path.invoiceSectionName
          account: path.billingAccountName
          profile: path.billingProfileName
          deleted: query.includeDeleted
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/providers/Microsoft.Education/labs/default/students/{studentAlias}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a lab student by alias
      effect: read
      questions:
      - How much credit has a specific student been given in my lab?
      - How do I look up one student by their alias?
      instructions:
      - text: Get student {alias} in the lab for invoice section {section}, account {account}, profile {profile}.
        slots:
          alias: path.studentAlias
          section: path.invoiceSectionName
          account: path.billingAccountName
          profile: path.billingProfileName
      - text: Show the details of lab student {alias} under billing account {account}, profile {profile}, section {section}.
        slots:
          alias: path.studentAlias
          account: path.billingAccountName
          profile: path.billingProfileName
          section: path.invoiceSectionName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/providers/Microsoft.Education/labs/default/students/{studentAlias}'].put
  update:
    x-apievangelist-phrasing:
      intent: Add or update a student in a lab
      effect: write
      questions:
      - How do I add a new student to my Azure Education lab with a budget?
      - Does a student need a valid tenant before they can accept the lab?
      instructions:
      - text: Add student {alias} to the lab for account {account}, profile {profile}, section {section} with {properties}.
        slots:
          alias: path.studentAlias
          account: path.billingAccountName
          profile: path.billingProfileName
          section: path.invoiceSectionName
          properties: requestBody.properties
      - text: Update lab student {alias} in invoice section {section} under account {account}, profile {profile}.
        slots:
          alias: path.studentAlias
          section: path.invoiceSectionName
          account: path.billingAccountName
          profile: path.billingProfileName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/providers/Microsoft.Education/labs/default/students/{studentAlias}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a student from a lab
      effect: destructive
      questions:
      - How do I remove a student from my Azure Education lab?
      - Can I drop one student by alias without affecting the others?
      instructions:
      - text: Delete student {alias} from the lab for account {account}, profile {profile}, section {section}.
        slots:
          alias: path.studentAlias
          account: path.billingAccountName
          profile: path.billingProfileName
          section: path.invoiceSectionName
      - text: Remove lab student {alias} under invoice section {section}, billing account {account}, profile {profile}.
        slots:
          alias: path.studentAlias
          section: path.invoiceSectionName
          account: path.billingAccountName
          profile: path.billingProfileName
      method: generated
      generated: '2026-09-26'