# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Hilt So Receipt API version: 1.0.0 extends: openapi/hilt-so-receipt-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: 10 - target: $.paths['/v1/receipt'].post update: x-apievangelist-phrasing: intent: Generate a signed receipt for a transaction effect: write questions: - How do I get a signed receipt for a Solana transaction? - Will generating a receipt twice for the same transaction create a duplicate? instructions: - text: Generate a receipt for transaction {tx_sig}. slots: tx_sig: requestBody.tx_sig - text: Create a signed receipt for {tx_sig} with memo {memo}. slots: tx_sig: requestBody.tx_sig memo: requestBody.memo method: generated generated: '2026-09-26' - target: $.paths['/v1/receipt/{receipt_id}'].get update: x-apievangelist-phrasing: intent: Get a full signed receipt effect: read questions: - Can I retrieve the full signed receipt JSON? - Where do I get the complete receipt record as its owner? instructions: - text: Get receipt {receipt_id}. slots: receipt_id: path.receipt_id - text: Show the full signed JSON of receipt {receipt_id}. slots: receipt_id: path.receipt_id method: generated generated: '2026-09-26' - target: $.paths['/v1/receipt/{receipt_id}/public'].get update: x-apievangelist-phrasing: intent: View a receipt's public proof effect: read questions: - What does the public proof page of a receipt show? - Can someone without an account view a receipt's proof details? instructions: - text: Show the public proof for receipt {receipt_id}. slots: receipt_id: path.receipt_id - text: Get shareable proof details for receipt {receipt_id}. slots: receipt_id: path.receipt_id method: generated generated: '2026-09-26' - target: $.paths['/v1/receipt/{receipt_id}/verify'].get update: x-apievangelist-phrasing: intent: Verify a receipt's signature effect: read questions: - Is this receipt's signature genuine? - Can an auditor check a receipt without logging in? instructions: - text: Verify receipt {receipt_id}. slots: receipt_id: path.receipt_id - text: Check the Ed25519 signature on receipt {receipt_id}. slots: receipt_id: path.receipt_id method: generated generated: '2026-09-26' - target: $.paths['/v1/receipt/{receipt_id}/pdf'].get update: x-apievangelist-phrasing: intent: Download a public receipt PDF effect: read questions: - Can I download a receipt as a public PDF? - Is there a PDF proof I can share with a customer? instructions: - text: Download the public PDF for receipt {receipt_id}. slots: receipt_id: path.receipt_id - text: Get the shareable PDF proof of receipt {receipt_id}. slots: receipt_id: path.receipt_id method: generated generated: '2026-09-26' - target: $.paths['/v1/receipt/{receipt_id}/pdf/private'].get update: x-apievangelist-phrasing: intent: Export a private receipt PDF effect: read questions: - Can I export a receipt PDF that includes my private invoice details? - Where's the signed-in version of a receipt PDF? instructions: - text: Export the private PDF of receipt {receipt_id}. slots: receipt_id: path.receipt_id - text: Download my authenticated PDF for receipt {receipt_id}. slots: receipt_id: path.receipt_id method: generated generated: '2026-09-26' - target: $.paths['/v1/receipts'].get update: x-apievangelist-phrasing: intent: List my receipts effect: read questions: - Which receipts have I generated? - Can I search my receipts by wallet or product? instructions: - text: List my receipts. - text: Show receipts for wallet {wallet}. slots: wallet: query.wallet - text: Search my receipts for {q}. slots: q: query.q method: generated generated: '2026-09-26' - target: $.paths['/v1/receipts/export.csv'].get update: x-apievangelist-phrasing: intent: Export my receipt ledger to CSV effect: read questions: - How do I download my receipts as a CSV for accounting? - Can I export only one product's receipts to a spreadsheet? instructions: - text: Export my receipt ledger as CSV. - text: Export a CSV of receipts for product {product_id}. slots: product_id: query.product_id method: generated generated: '2026-09-26' - target: $.paths['/v1/receipt/{receipt_id}/invoice-metadata'].patch update: x-apievangelist-phrasing: intent: Add invoice details to a receipt effect: write questions: - Can I add an invoice number and customer name to a receipt? - Where do I store billing references on a receipt? instructions: - text: Set invoice number {invoice_number} on receipt {receipt_id}. slots: invoice_number: requestBody.invoice_number receipt_id: path.receipt_id - text: Add customer {customer_name} ({customer_email}) to receipt {receipt_id}. slots: customer_name: requestBody.customer_name customer_email: requestBody.customer_email receipt_id: path.receipt_id method: generated generated: '2026-09-26' - target: $.paths['/v1/receipt/{receipt_id}/send-proof'].post update: x-apievangelist-phrasing: intent: Email a receipt's proof link effect: write questions: - Can I email a customer the proof link for their receipt? - Can I include a note when sending a receipt proof? instructions: - text: Email the proof for receipt {receipt_id} to {email}. slots: receipt_id: path.receipt_id email: requestBody.email - text: Send receipt {receipt_id}'s proof to {email} with note {note}. slots: receipt_id: path.receipt_id email: requestBody.email note: requestBody.note method: generated generated: '2026-09-26'