# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand. overlay: 1.0.0 info: title: API Evangelist conversational phrasing for Aiapplyd Billing API version: 1.0.0 extends: openapi/aiapplyd-billing-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: 12 - target: $.paths['/billing/create-checkout-session'].post update: x-apievangelist-phrasing: intent: Start a checkout for a plan or token pack effect: write questions: - How do I subscribe or buy a token pack with a card? - Can I choose monthly or yearly billing at checkout? instructions: - text: Create a checkout session for price {priceId}. slots: priceId: requestBody.priceId - text: Start checkout for {priceId} billed {interval}. slots: priceId: requestBody.priceId interval: requestBody.interval method: generated generated: '2026-09-26' - target: $.paths['/billing/create-portal-session'].post update: x-apievangelist-phrasing: intent: Open the billing portal effect: write questions: - Where can I update my payment method or manage my subscription? - Can I get a link to the self-service billing portal? instructions: - text: Open my billing portal. - text: Create a billing portal session that returns to {returnUrl}. slots: returnUrl: requestBody.returnUrl method: generated generated: '2026-09-26' - target: $.paths['/billing/sync-after-checkout'].post update: x-apievangelist-phrasing: intent: Sync my subscription after checkout effect: write questions: - My payment went through but my plan hasn't updated, what can refresh it? - What syncs subscription data after a successful checkout? instructions: - text: Sync my subscription after checkout. - text: Refresh my plan now that payment succeeded. method: generated generated: '2026-09-26' - target: $.paths['/billing/subscription'].get update: x-apievangelist-phrasing: intent: Get my subscription and token balance effect: read questions: - What plan am I on and how many tokens do I have left? - When does my current subscription renew? instructions: - text: Show my subscription details. - text: Tell me my current token balance. method: generated generated: '2026-09-26' - target: $.paths['/billing/cancel-subscription'].post update: x-apievangelist-phrasing: intent: Cancel my subscription effect: destructive questions: - Can I cancel my subscription at the end of the billing period instead of right away? - How do I cancel my plan immediately? instructions: - text: Cancel my subscription at the end of the period. - text: 'Cancel my subscription now with reason {reason}: {cancelImmediately}.' slots: reason: requestBody.reason cancelImmediately: requestBody.cancelImmediately method: generated generated: '2026-09-26' - target: $.paths['/billing/subscription/switch'].post update: x-apievangelist-phrasing: intent: Switch to a different plan effect: write questions: - Can I upgrade my plan and pay the prorated difference? - When does a downgrade take effect? instructions: - text: Switch my plan to {newPriceId}. slots: newPriceId: requestBody.newPriceId - text: Change my subscription to {newPriceId} billed {interval}. slots: newPriceId: requestBody.newPriceId interval: requestBody.interval method: generated generated: '2026-09-26' - target: $.paths['/billing/invoices'].get update: x-apievangelist-phrasing: intent: List my invoices effect: read questions: - Where can I find my past invoices? - Can I page through my invoice history? instructions: - text: List my invoices. - text: Show {limit} invoices after {startingAfter}. slots: limit: query.limit startingAfter: query.startingAfter method: generated generated: '2026-09-26' - target: $.paths['/billing/usage'].get update: x-apievangelist-phrasing: intent: Check per-action usage and limits effect: read questions: - How much of each action's quota have I used? - Which AI actions am I close to the limit on? instructions: - text: Show my action usage and remaining quota. - text: List my per-action limits. method: generated generated: '2026-09-26' - target: $.paths['/billing/action-costs'].get update: x-apievangelist-phrasing: intent: See estimated token cost per AI action effect: read questions: - How many tokens does each AI action typically cost? - What's the maximum token cost of tailoring a resume? instructions: - text: List the token cost estimates for every AI action. - text: Show min, typical and max token costs per action. method: generated generated: '2026-09-26' - target: $.paths['/native-billing/bootstrap'].post update: x-apievangelist-phrasing: intent: Get the native app billing catalog effect: read questions: - What products are available for in-app purchase on mobile? - Which store account binding does the native app use for purchases? instructions: - text: Get the native billing bootstrap. - text: Load the in-app product catalog and store binding. method: generated generated: '2026-09-26' - target: $.paths['/billing/native/verify'].post update: x-apievangelist-phrasing: intent: Verify an in-app store purchase effect: write questions: - How is an in-app purchase checked and turned into an entitlement? - My mobile purchase went through, can it be verified with the store? instructions: - text: Verify my native store purchase. - text: Check my app store purchase and grant the entitlement. method: generated generated: '2026-09-26' - target: $.paths['/native-billing/purchases/accept'].post update: x-apievangelist-phrasing: intent: Settle a verified in-app token pack effect: write questions: - Will tokens from an in-app token pack be credited only once? - How do verified mobile token pack purchases get added to my balance? instructions: - text: Accept my verified token pack purchase. - text: Credit the tokens from my in-app pack purchase. method: generated generated: '2026-09-26'