# 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 AttestationClient Attestation API
  version: 1.0.0
extends: openapi/microsoft-azure-attestation-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['/attest/OpenEnclave'].post
  update:
    x-apievangelist-phrasing:
      intent: Attest an OpenEnclave report
      effect: write
      questions:
      - How do I verify an OpenEnclave report with Azure Attestation and get a token back?
      - Can I test a draft attestation policy against an OpenEnclave report?
      instructions:
      - text: Attest OpenEnclave report {report} with runtime data {runtimeData}.
        slots:
          report: requestBody.report
          runtimeData: requestBody.runtimeData
      - text: Attest OpenEnclave report {report} against draft policy {draftPolicy}.
        slots:
          report: requestBody.report
          draftPolicy: requestBody.draftPolicyForAttestation
      method: generated
      generated: '2026-09-26'
- target: $.paths['/attest/SgxEnclave'].post
  update:
    x-apievangelist-phrasing:
      intent: Attest an SGX enclave quote
      effect: write
      questions:
      - How do I attest an Intel SGX enclave quote and receive an attestation token?
      - Can I include a nonce when attesting an SGX quote?
      instructions:
      - text: Attest SGX enclave quote {quote} with runtime data {runtimeData}.
        slots:
          quote: requestBody.quote
          runtimeData: requestBody.runtimeData
      - text: Attest SGX quote {quote} using nonce {nonce}.
        slots:
          quote: requestBody.quote
          nonce: requestBody.nonce
      method: generated
      generated: '2026-09-26'
- target: $.paths['/attest/Tpm'].post
  update:
    x-apievangelist-phrasing:
      intent: Attest TPM or VBS enclave evidence
      effect: write
      questions:
      - How do I attest TPM-based evidence from a VBS enclave with Azure Attestation?
      - Can Azure Attestation verify evidence from a virtualization-based security enclave?
      instructions:
      - text: Attest the VBS enclave TPM evidence {data}.
        slots:
          data: requestBody.data
      - text: Submit TPM attestation data {data} for verification.
        slots:
          data: requestBody.data
      method: generated
      generated: '2026-09-26'
- target: $.paths['/attest/SevSnpVm'].post
  update:
    x-apievangelist-phrasing:
      intent: Attest an AMD SEV-SNP virtual machine
      effect: write
      questions:
      - How do I attest the boot chain of an AMD SEV-SNP confidential VM?
      - Can I verify a SEV-SNP VM report against a draft attestation policy?
      instructions:
      - text: Attest SEV-SNP VM report {report} with runtime data {runtimeData}.
        slots:
          report: requestBody.report
          runtimeData: requestBody.runtimeData
      - text: Attest confidential VM report {report} using draft policy {draftPolicy}.
        slots:
          report: requestBody.report
          draftPolicy: requestBody.draftPolicyForAttestation
      method: generated
      generated: '2026-09-26'