# 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 Access Token API
  version: 1.0.0
extends: openapi/microsoft-azure-access-token-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: 3
- target: $.paths['/oauth2/token'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a registry access token with credentials
      effect: read
      questions:
      - How do I get a Container Registry access token using my username and password?
      - Which service and scope do I pass when logging in for a registry access token?
      instructions:
      - text: Get a registry access token for service {service} with scope {scope} using my login.
        slots:
          service: query.service
          scope: query.scope
      - text: Log in to registry {service} and issue a token scoped to {scope}.
        slots:
          service: query.service
          scope: query.scope
      method: generated
      generated: '2026-10-01'
- target: $.paths['/oauth2/token'].post
  update:
    x-apievangelist-phrasing:
      intent: Exchange a registry refresh token for an access token
      effect: write
      questions:
      - Can I trade a registry refresh token for a short-lived access token?
      - What grant type do I use to exchange a refresh token with the registry?
      instructions:
      - text: Exchange refresh token {refresh} for a registry access token on {service} with scope {scope}.
        slots:
          refresh: requestBody.refresh_token
          service: formData.service
          scope: requestBody.scope
      - text: Swap refresh token {refresh} using grant type {grant} for service {service}, scope {scope}.
        slots:
          refresh: requestBody.refresh_token
          grant: requestBody.grant_type
          service: formData.service
          scope: requestBody.scope
      method: generated
      generated: '2026-10-01'
- target: $.paths['/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.VideoIndexer/accounts/{accountName}/generateAccessToken'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a Video Indexer access token
      effect: write
      questions:
      - How do I generate an access token for an Azure Video Indexer account?
      - Can I scope a Video Indexer token to a single video or project?
      instructions:
      - text: Generate a {permission} Video Indexer token for account {account} with scope {scope}.
        slots:
          permission: requestBody.permissionType
          account: path.accountName
          scope: requestBody.scope
      - text: Create a {permission} token for Video Indexer account {account}, scope {scope}, video {video}.
        slots:
          permission: requestBody.permissionType
          account: path.accountName
          scope: requestBody.scope
          video: requestBody.videoId
      method: generated
      generated: '2026-10-01'