# 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 InstanceMetadataClient Get Token API
  version: 1.0.0
extends: openapi/microsoft-azure-get-token-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: 1
- target: $.paths['/identity/oauth2/token'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a managed identity access token
      effect: read
      questions:
      - How does code on an Azure VM get an Azure AD token from its managed identity?
      - Can I pick a specific user-assigned identity by client id when requesting a token?
      - Is there a way to skip the cached token and force a fresh one?
      instructions:
      - text: Get a managed identity token for resource {resource} with Metadata set to {metadata}.
        slots:
          resource: query.resource
          metadata: header.Metadata
      - text: Request a token for {resource} using the user-assigned identity with client id {client_id}.
        slots:
          resource: query.resource
          client_id: query.client_id
      - text: Fetch a fresh uncached token for {resource}, bypassing the cache ({bypass_cache}).
        slots:
          resource: query.resource
          bypass_cache: query.bypass_cache
      method: generated
      generated: '2026-09-26'