API Evangelist conversational phrasing for Microsoft Azure ConfidentialLedgerClient App API

# 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 ConfidentialLedgerClient App API
  version: 1.0.0
extends: openapi/microsoft-azure-app-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: 13
- target: $.paths['/app/governance/constitution'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the ledger's governance constitution
      effect: read
      questions:
      - What constitution script governs proposals on my Azure Confidential Ledger?
      - How are consortium member proposals assessed and applied on the ledger?
      instructions:
      - text: Show me the governance constitution for this confidential ledger.
      - text: Get the constitution script used to apply consortium proposals.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/app/governance/members'].get
  update:
    x-apievangelist-phrasing:
      intent: List the ledger's consortium members
      effect: read
      questions:
      - Who are the consortium members that can manage my confidential ledger?
      - Which members have governance rights over the ledger?
      instructions:
      - text: List the consortium members of this confidential ledger.
      - text: Show everyone in the ledger's governance consortium.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/app/enclaveQuotes'].get
  update:
    x-apievangelist-phrasing:
      intent: Get SGX enclave quotes for all ledger nodes
      effect: read
      questions:
      - How do I verify that each confidential ledger node runs a genuine SGX enclave?
      - Where can I get the enclave attestation quotes for the ledger's nodes?
      instructions:
      - text: Get the enclave quotes for every node of the confidential ledger.
      - text: Fetch SGX attestation measurements so I can validate the ledger nodes.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/app/collections'].get
  update:
    x-apievangelist-phrasing:
      intent: List collection IDs in the ledger
      effect: read
      questions:
      - Which collections of entries have been created in my confidential ledger?
      - What collection IDs exist on the ledger?
      instructions:
      - text: List all collection IDs in the confidential ledger.
      - text: Show me the user-created collections on this ledger.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/app/transactions'].get
  update:
    x-apievangelist-phrasing:
      intent: List ledger entries in a transaction range
      effect: read
      questions:
      - How do I read a range of entries from my confidential ledger?
      - Can I limit the ledger entries returned to one collection?
      - What entries were written between two transaction IDs?
      instructions:
      - text: List ledger entries from transaction {fromTransactionId} to {toTransactionId}.
        slots:
          fromTransactionId: query.fromTransactionId
          toTransactionId: query.toTransactionId
      - text: Show all entries in ledger collection {collectionId}.
        slots:
          collectionId: query.collectionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/app/transactions'].post
  update:
    x-apievangelist-phrasing:
      intent: Write an entry to the confidential ledger
      effect: write
      questions:
      - How do I append a new record to my confidential ledger?
      - Can I write a ledger entry into a specific collection?
      instructions:
      - text: Write {contents} to the confidential ledger.
        slots:
          contents: requestBody.contents
      - text: Append entry {contents} to ledger collection {collectionId}.
        slots:
          contents: requestBody.contents
          collectionId: query.collectionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/app/transactions/{transactionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the ledger entry at a transaction ID
      effect: read
      questions:
      - How do I read the ledger entry recorded at a particular transaction ID?
      - Why might an older ledger entry come back as not ready yet?
      instructions:
      - text: Get the ledger entry at transaction {transactionId}.
        slots:
          transactionId: path.transactionId
      - text: Read entry {transactionId} from ledger collection {collectionId}.
        slots:
          transactionId: path.transactionId
          collectionId: query.collectionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/app/transactions/{transactionId}/receipt'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a receipt certifying a ledger transaction
      effect: read
      questions:
      - How can I get cryptographic proof that a ledger entry was committed?
      - Can I obtain a receipt certifying the ledger contents at a transaction?
      instructions:
      - text: Get the receipt for ledger transaction {transactionId}.
        slots:
          transactionId: path.transactionId
      - text: Fetch a certified receipt proving transaction {transactionId} is in the ledger.
        slots:
          transactionId: path.transactionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/app/transactions/{transactionId}/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the commit status of a ledger transaction
      effect: read
      questions:
      - Has my ledger write been committed yet?
      - How do I check the status of a confidential ledger transaction?
      instructions:
      - text: Check the status of ledger transaction {transactionId}.
        slots:
          transactionId: path.transactionId
      - text: Tell me whether transaction {transactionId} is committed.
        slots:
          transactionId: path.transactionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/app/transactions/current'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the latest ledger entry
      effect: read
      questions:
      - What is the most recent value written to my confidential ledger?
      - Can I read the current entry of a specific ledger collection?
      instructions:
      - text: Get the current value in the confidential ledger.
      - text: Show the latest entry in ledger collection {collectionId}.
        slots:
          collectionId: query.collectionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/app/users/{userId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a confidential ledger user
      effect: read
      questions:
      - What role does a given user have on my confidential ledger?
      - How do I look up one ledger user's details?
      instructions:
      - text: Get ledger user {userId}.
        slots:
          userId: path.userId
      - text: Show the role assigned to user {userId} on the ledger.
        slots:
          userId: path.userId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/app/users/{userId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove a user from the confidential ledger
      effect: destructive
      questions:
      - How do I revoke a user's access to my confidential ledger?
      - Can I delete a user from the ledger entirely?
      instructions:
      - text: Delete user {userId} from the confidential ledger.
        slots:
          userId: path.userId
      - text: Revoke ledger access for {userId}.
        slots:
          userId: path.userId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/app/users/{userId}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Add or update a confidential ledger user
      effect: write
      questions:
      - How do I grant a new user access to my confidential ledger?
      - Can I change an existing ledger user's role with a merge patch?
      instructions:
      - text: Add user {userId} to the ledger with details {userDetails}.
        slots:
          userId: path.userId
          userDetails: body.userDetails
      - text: Update ledger user {userId} to {userDetails}.
        slots:
          userId: path.userId
          userDetails: body.userDetails
      method: generated
      generated: '2026-09-26'