API Evangelist conversational phrasing for Agoragentic Agent OS and Marketplace Router x402 Payments API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Agoragentic Agent OS and Marketplace Router x402 Payments API
  version: 1.0.0
extends: openapi/agoragentic-com-x402-payments-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: 32
- target: $.paths['/agentkit/world'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the World AgentKit x402 free-trial status
      effect: read
      questions:
      - Is the World AgentKit human-backed x402 free trial turned on?
      - How many free uses per resource does the AgentKit extension allow?
      instructions:
      - text: Show the World AgentKit extension status.
      - text: Check whether the human-backed AgentKit x402 trial is configured and ready.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/info'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the x402 gateway status
      effect: read
      questions:
      - Is the x402 payment gateway operational right now?
      - Why does the x402 gateway report read-only while custody is frozen?
      instructions:
      - text: Get the x402 gateway status.
      - text: Show whether x402 payments are frozen or operational.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/info'].head
  update:
    x-apievangelist-phrasing:
      intent: Probe x402 gateway status headers only
      effect: read
      questions:
      - Can I check the x402 gateway with a HEAD request and no response body?
      - What cache headers does the x402 status endpoint return?
      instructions:
      - text: Send a HEAD probe to the x402 info endpoint.
      - text: Fetch just the response headers of the x402 gateway status.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/marketplace'].get
  update:
    x-apievangelist-phrasing:
      intent: Explain the x402 marketplace bridge
      effect: read
      questions:
      - What's the difference between the curated x402 stable edge and the main marketplace x402 rail?
      - Which domain should I use for paying marketplace services over x402?
      instructions:
      - text: Explain the x402 marketplace bridge setup.
      - text: Show how the stable x402 edge and the compatibility rail are split.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/listings'].get
  update:
    x-apievangelist-phrasing:
      intent: List compatibility x402-enabled listings
      effect: read
      questions:
      - Which marketplace listings can legacy listing-ID x402 clients pay for?
      - What makes a listing show up in the compatibility x402 catalog?
      instructions:
      - text: List all x402-enabled compatibility listings.
      - text: Show the legacy listing-ID x402 catalog.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/external-resources'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse verified external x402-native resources
      effect: read
      questions:
      - What third-party x402-native services have been verified for discovery?
      - Can I filter external x402 resources by category?
      - Are external x402 resources settled or proxied through the marketplace?
      instructions:
      - text: List verified external x402 resources in category {category}.
        slots:
          category: query.category
      - text: Show {limit} external x402-native resources starting at offset {offset}.
        slots:
          limit: query.limit
          offset: query.offset
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/external-resources/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one verified external x402 resource
      effect: read
      questions:
      - Where do I see the details of a single external x402-native resource?
      - Why would an external x402 resource return not found?
      instructions:
      - text: Show external x402 resource {id}.
        slots:
          id: path.id
      - text: Get pricing and details for verified external resource {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/settlement-check'].get
  update:
    x-apievangelist-phrasing:
      intent: Read how the free settlement check works
      effect: read
      questions:
      - What inputs does the free x402 settlement check expect?
      - Is there any cost or auth needed to use the settlement checker?
      instructions:
      - text: Show the usage contract for the x402 settlement check.
      - text: Explain what I need to send to verify a settlement.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/settlement-check'].post
  update:
    x-apievangelist-phrasing:
      intent: Verify a USDC payment settled on Base
      effect: read
      questions:
      - Did a USDC transfer for this transaction hash actually settle on Base mainnet?
      - Can I confirm an x402 payment went to the right payee for the right amount?
      - Why must an expected amount come with a payee or payer?
      instructions:
      - text: Check that transaction {tx_hash} settled on-chain.
        slots:
          tx_hash: requestBody.tx_hash
      - text: Verify {tx_hash} paid {expected_amount_usdc} USDC to {expected_pay_to}.
        slots:
          tx_hash: requestBody.tx_hash
          expected_amount_usdc: requestBody.expected_amount_usdc
          expected_pay_to: requestBody.expected_pay_to
      - text: Confirm transaction {tx_hash} came from payer {expected_payer}.
        slots:
          tx_hash: requestBody.tx_hash
          expected_payer: requestBody.expected_payer
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/fluxa-wallet/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check the FluxA wallet payment rail status
      effect: read
      questions:
      - Is the FluxA wallet x402 rail enabled for my agent?
      - What amount cap and safety limits apply to FluxA wallet payments?
      instructions:
      - text: Show the FluxA wallet rail status.
      - text: Check whether FluxA wallet authorization is configured.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/fluxa-wallet/mandates/intent'].post
  update:
    x-apievangelist-phrasing:
      intent: Draft a FluxA intent mandate
      effect: write
      questions:
      - How do I create a FluxA spending mandate for my owner to sign?
      - Does drafting a FluxA mandate move any funds?
      instructions:
      - text: Create a FluxA intent mandate draft for {intent}.
        slots:
          intent: requestBody.intent
      - text: Draft a FluxA mandate describing the spending intent {intent}.
        slots:
          intent: requestBody.intent
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/fluxa-wallet/mandates/{mandate_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a FluxA mandate's status
      effect: read
      questions:
      - Has my owner signed the FluxA mandate yet?
      - Where do I look up a FluxA mandate after signing?
      instructions:
      - text: Get the status of FluxA mandate {mandate_id}.
        slots:
          mandate_id: path.mandate_id
      - text: Check whether mandate {mandate_id} has been signed.
        slots:
          mandate_id: path.mandate_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/fluxa-wallet/payments/x402-v3'].post
  update:
    x-apievangelist-phrasing:
      intent: Authorize an x402 payment under a FluxA mandate
      effect: write
      questions:
      - How do I turn an x402 payment-required response into a FluxA-mandated payment?
      - When will FluxA mandate payment authorization be usable again?
      instructions:
      - text: Authorize the payment {payment_required} under FluxA mandate {mandate_id}.
        slots:
          payment_required: requestBody.payment_required
          mandate_id: requestBody.mandate_id
      - text: Use mandate {mandate_id} to authorize the x402 challenge for intent {intent}.
        slots:
          mandate_id: requestBody.mandate_id
          intent: requestBody.intent
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/fluxa-wallet/payments/x402-v2'].post
  update:
    x-apievangelist-phrasing:
      intent: Authorize an x402 v2 payment through FluxA
      effect: write
      questions:
      - Can FluxA authorize a payment for an older x402 v2 challenge?
      - Can I say which assets I prefer when paying an x402 v2 challenge with FluxA?
      instructions:
      - text: Authorize the x402 v2 challenge {payment_required} with FluxA mandate {mandate_id}.
        slots:
          payment_required: requestBody.payment_required
          mandate_id: requestBody.mandate_id
      - text: Pay the v2 challenge under mandate {mandate_id} preferring assets {preferred_assets}.
        slots:
          mandate_id: requestBody.mandate_id
          preferred_assets: requestBody.preferred_assets
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/discover'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the compatibility x402 discovery catalog
      effect: read
      questions:
      - Is there a machine-readable x402 catalog older agent buyers can read?
      - Where does stable-resource x402 discovery live now?
      instructions:
      - text: Fetch the compatibility x402 discovery catalog.
      - text: Show the legacy machine-readable x402 discover document.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/execute/match'].get
  update:
    x-apievangelist-phrasing:
      intent: Match a task to a paid x402 route
      effect: read
      questions:
      - Which x402-payable service would handle my task at my price ceiling?
      - Can I pick the payment network and asset when matching an x402 route?
      - Can anonymous buyers get an x402 route match without an account?
      instructions:
      - text: Find an x402 route match for the task {task}.
        slots:
          task: query.task
      - text: Match {task} over x402 for at most {max_cost} on network {payment_network}.
        slots:
          task: query.task
          max_cost: query.max_cost
          payment_network: query.payment_network
      - text: Match {task} to trusted x402 sellers in category {category}.
        slots:
          task: query.task
          category: query.category
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/execute'].post
  update:
    x-apievangelist-phrasing:
      intent: Execute a routed x402 quote
      effect: write
      questions:
      - How do I pay for and run an x402 quote I was given?
      - What approved payload hash do I need to send with an x402 execute call?
      instructions:
      - text: Execute x402 quote {quote_id} with input {input}.
        slots:
          quote_id: requestBody.quote_id
          input: requestBody.input
      - text: Run x402 quote {quote_id} paying from wallet {wallet_address}.
        slots:
          quote_id: requestBody.quote_id
          wallet_address: requestBody.wallet_address
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/invoke'].get
  update:
    x-apievangelist-phrasing:
      intent: Explain the missing listing ID on legacy x402 invoke
      effect: read
      questions:
      - Why does the legacy x402 invoke path need a listing ID?
      - What should my agent call instead when it hits the bare x402 invoke URL?
      instructions:
      - text: Show the recovery routes for the bare x402 invoke path.
      - text: Explain which routes to use when an x402 invoke has no listing UUID.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/invoke'].post
  update:
    x-apievangelist-phrasing:
      intent: Explain missing listing ID for POST x402 invoke
      effect: read
      questions:
      - What happens if my agent POSTs to x402 invoke without a listing?
      - Is there a collection-level x402 invoke route for POST callers?
      instructions:
      - text: POST to the bare x402 invoke path to get the recovery guidance.
      - text: Tell me the correct x402 endpoint for a POST that lacked a listing ID.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/invoke/{listing_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get x402 payment metadata for a listing
      effect: read
      questions:
      - What does a listing cost over x402 and what input schema does it take?
      - Which payment methods does an x402 listing accept before I call it?
      instructions:
      - text: Get the x402 pricing and schemas for listing {listing_id}.
        slots:
          listing_id: path.listing_id
      - text: Show the payment-method metadata for x402 listing {listing_id}.
        slots:
          listing_id: path.listing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/invoke/{listing_id}'].post
  update:
    x-apievangelist-phrasing:
      intent: Invoke a listing with an x402 payment
      effect: write
      questions:
      - How do I pay for and call one marketplace listing using x402?
      - Is invoking a listing through the legacy x402 route available right now?
      instructions:
      - text: Invoke x402 listing {listing_id} with input {input}.
        slots:
          listing_id: path.listing_id
          input: requestBody.input
      - text: Pay and call listing {listing_id} over the compatibility x402 route.
        slots:
          listing_id: path.listing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/invoke/{listing_id}'].head
  update:
    x-apievangelist-phrasing:
      intent: Check whether an x402 listing exists
      effect: read
      questions:
      - Can I quickly check that an x402 listing exists without fetching its details?
      - Is a given listing eligible for x402 invocation?
      instructions:
      - text: Probe whether x402 listing {listing_id} exists.
        slots:
          listing_id: path.listing_id
      - text: Run a HEAD eligibility check on listing {listing_id}.
        slots:
          listing_id: path.listing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/invoke/{listing_id}/discover'].get
  update:
    x-apievangelist-phrasing:
      intent: Read extended x402 discovery for a listing
      effect: read
      questions:
      - What payment-required details do older agents get from a listing's discover route?
      - Is there a per-listing x402 discover document?
      instructions:
      - text: Get the x402 discover document for listing {listing_id}.
        slots:
          listing_id: path.listing_id
      - text: Show the payment-required metadata on the discover child route of {listing_id}.
        slots:
          listing_id: path.listing_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/test/echo'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the free x402 test canary instructions
      effect: read
      questions:
      - How do I test my x402 client end to end without paying?
      - What does the $0.00 x402 echo test expect?
      instructions:
      - text: Show the instructions for the x402 test echo.
      - text: Explain how to use the zero-dollar x402 canary.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/test/echo'].post
  update:
    x-apievangelist-phrasing:
      intent: Call the $0.00 x402 pipeline canary
      effect: read
      questions:
      - Can I trigger a zero-cost x402 challenge to test payment handling?
      - Is the x402 echo canary callable while custody is frozen?
      instructions:
      - text: Call the x402 test echo canary.
      - text: Trigger the free x402 challenge to exercise my payment pipeline.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/convert'].post
  update:
    x-apievangelist-phrasing:
      intent: Convert an x402 buyer wallet into an agent
      effect: write
      questions:
      - How do I turn the wallet I've been paying x402 with into a marketplace agent account?
      - What signature proof do I need to convert my x402 buyer wallet?
      instructions:
      - text: Convert wallet {wallet_address} into an agent named {name} using proof {proof}.
        slots:
          wallet_address: requestBody.wallet_address
          name: requestBody.name
          proof: requestBody.proof
      - text: Create agent {name} from x402 buyer wallet {wallet_address} with description {description} and proof {proof}.
        slots:
          name: requestBody.name
          wallet_address: requestBody.wallet_address
          description: requestBody.description
          proof: requestBody.proof
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/claim'].post
  update:
    x-apievangelist-phrasing:
      intent: Read x402 receipts and vault items by wallet proof
      effect: read
      questions:
      - Can I see my paid x402 receipts before creating a full agent account?
      - Which vault items has my x402 wallet bought?
      instructions:
      - text: Fetch receipts for wallet {wallet_address} using proof {proof}.
        slots:
          wallet_address: requestBody.wallet_address
          proof: requestBody.proof
      - text: Show {limit} vault items for {wallet_address} with payloads, proven by {proof}.
        slots:
          limit: requestBody.limit
          wallet_address: requestBody.wallet_address
          proof: requestBody.proof
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/escrow/{invocationId}/status'].get
  update:
    x-apievangelist-phrasing:
      intent: Check escrow status for an x402 invocation
      effect: read
      questions:
      - What's the escrow mode and status on one of my x402 calls?
      - Who evaluated my x402 invocation and where is the dispute link?
      instructions:
      - text: Get the escrow status for invocation {invocationId}.
        slots:
          invocationId: path.invocationId
      - text: Show the evaluator and escrow state of x402 call {invocationId}.
        slots:
          invocationId: path.invocationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/escrow/{invocationId}/dispute'].post
  update:
    x-apievangelist-phrasing:
      intent: File an escrow dispute on an x402 invocation
      effect: write
      questions:
      - How do I dispute the outcome of an x402 call held in escrow?
      - Why is escrow dispute filing returning service unavailable?
      instructions:
      - text: File a dispute on x402 invocation {invocationId}.
        slots:
          invocationId: path.invocationId
      - text: Open an escrow dispute for call {invocationId}.
        slots:
          invocationId: path.invocationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/job-contracts/{invocationId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the x402 job contract for an invocation
      effect: read
      questions:
      - What does the evaluator-attested job contract say for my x402 call?
      - Where do I find the decision and attestation hashes for a job contract?
      instructions:
      - text: Show the x402 job contract for invocation {invocationId}.
        slots:
          invocationId: path.invocationId
      - text: Get the canonical job-contract view of {invocationId}.
        slots:
          invocationId: path.invocationId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/job-contracts/{invocationId}/proof'].get
  update:
    x-apievangelist-phrasing:
      intent: Get on-chain proof for an x402 job contract
      effect: read
      questions:
      - Has the decision for my x402 job contract been submitted on-chain?
      - Can I have the job-contract proof verified when I fetch it?
      instructions:
      - text: Get the job-contract proof for invocation {invocationId}.
        slots:
          invocationId: path.invocationId
      - text: Fetch and verify the on-chain decision proof for job contract {invocationId} with verify set to {verify}.
        slots:
          invocationId: path.invocationId
          verify: query.verify
      method: generated
      generated: '2026-09-26'
- target: $.paths['/x402/invocations/{id}/proof'].get
  update:
    x-apievangelist-phrasing:
      intent: Look up x402 proof via the legacy invocations path
      effect: read
      questions:
      - Does the older invocations proof URL still work for x402 calls?
      - Where do legacy clients fetch an x402 invocation's proof?
      instructions:
      - text: Get proof for x402 invocation {id} using the legacy invocations alias.
        slots:
          id: path.id
      - text: Look up the legacy invocation proof for {id} with verification {verify}.
        slots:
          id: path.id
          verify: query.verify
      method: generated
      generated: '2026-09-26'