# 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 Join Request API
  version: 1.0.0
extends: openapi/microsoft-azure-joinrequest-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: 5
- target: $.paths['/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/providers/Microsoft.Education/labs/default/joinRequests'].get
  update:
    x-apievangelist-phrasing:
      intent: List student join requests for a lab
      effect: read
      questions:
      - Which students have asked to join my education lab?
      - Can I include denied join requests when listing a lab's requests?
      instructions:
      - text: List student join requests for the lab under billing account {account}, billing profile {profile}, invoice section {section}.
        slots:
          account: path.billingAccountName
          profile: path.billingProfileName
          section: path.invoiceSectionName
      - text: Show all join requests for invoice section {section}, including denied ones ({denied}).
        slots:
          section: path.invoiceSectionName
          denied: query.includeDenied
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/providers/Microsoft.Education/labs/default/joinRequests/{joinRequestName}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a student join request
      effect: read
      questions:
      - What are the details of one student's request to join my lab?
      - Can I look up a single lab join request by name?
      instructions:
      - text: Get join request {request} for billing account {account}, profile {profile}, invoice section {section}.
        slots:
          request: path.joinRequestName
          account: path.billingAccountName
          profile: path.billingProfileName
          section: path.invoiceSectionName
      - text: Show the student's lab join request {request}.
        slots:
          request: path.joinRequestName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/providers/Microsoft.Education/labs/default/joinRequests/{joinRequestName}/approve'].post
  update:
    x-apievangelist-phrasing:
      intent: Approve a student's request to join a lab
      effect: write
      questions:
      - How do I approve a student who asked to join my redeemable lab?
      - Can I let a pending student into the lab?
      instructions:
      - text: Approve join request {request} for billing account {account}, profile {profile}, invoice section {section}.
        slots:
          request: path.joinRequestName
          account: path.billingAccountName
          profile: path.billingProfileName
          section: path.invoiceSectionName
      - text: Let the student behind request {request} into the lab.
        slots:
          request: path.joinRequestName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/providers/Microsoft.Education/labs/default/joinRequests/{joinRequestName}/deny'].post
  update:
    x-apievangelist-phrasing:
      intent: Deny a student's request to join a lab
      effect: destructive
      questions:
      - Can I reject a student's request to join my lab?
      - What happens to a join request after I deny it?
      instructions:
      - text: Deny join request {request} for billing account {account}, profile {profile}, invoice section {section}.
        slots:
          request: path.joinRequestName
          account: path.billingAccountName
          profile: path.billingProfileName
          section: path.invoiceSectionName
      - text: Reject the student lab request {request}.
        slots:
          request: path.joinRequestName
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/Microsoft.Education/redeemInvitationCode'].post
  update:
    x-apievangelist-phrasing:
      intent: Redeem an invitation code to join a lab
      effect: write
      questions:
      - How does a student use an invite code to join a redeemable lab?
      - What details do I give along with a lab invitation code?
      instructions:
      - text: Redeem invitation code {code} for {first} {last}.
        slots:
          code: requestBody.redeemCode
          first: requestBody.firstName
          last: requestBody.lastName
      - text: Join the lab with invite code {code} as student {first} {last}.
        slots:
          code: requestBody.redeemCode
          first: requestBody.firstName
          last: requestBody.lastName
      method: generated
      generated: '2026-09-26'