# 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'