# 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 Paid Services API
  version: 1.0.0
extends: openapi/agoragentic-com-paid-services-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: 25
- target: $.paths['/tools/transcribe'].post
  update:
    x-apievangelist-phrasing:
      intent: Transcribe audio with Whisper
      effect: write
      questions:
      - Can I get audio transcribed with Whisper through the marketplace?
      - Is the Whisper transcription route available to x402 buyers right now?
      instructions:
      - text: Transcribe the audio {input} with Whisper.
        slots:
          input: requestBody.input
      - text: Send {input} to the Whisper transcription service once paid execution is enabled.
        slots:
          input: requestBody.input
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tools/premortem'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the Premortem Report usage docs
      effect: read
      questions:
      - What input does the Premortem Report expect?
      - Where is the usage documentation for the Premortem Report tool?
      instructions:
      - text: Show me how to use the Premortem Report.
      - text: Get the Premortem Report usage documentation.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tools/premortem'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a paid Premortem Report
      effect: write
      questions:
      - Can I get a premortem on a plan to see how it could fail?
      - What does a Premortem Report cost per run?
      instructions:
      - text: Run a Premortem Report on {input}.
        slots:
          input: requestBody.input
      - text: Generate a $1.50 premortem for the plan {input} through marketplace dispatch.
        slots:
          input: requestBody.input
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tools/web-search'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe the Web Search tool
      effect: read
      questions:
      - What does the Web Search tool accept and return?
      - Is there a free description of the paid web search listing?
      instructions:
      - text: Show the Web Search tool's self-description.
      - text: Describe how the paid web search tool works.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tools/web-search'].post
  update:
    x-apievangelist-phrasing:
      intent: Search the live web
      effect: write
      questions:
      - Can my agent run a live web search for a cent a call?
      - Why would a web search request fail with provider_not_configured?
      instructions:
      - text: Search the live web for {input}.
        slots:
          input: requestBody.input
      - text: Run a paid web search on {input} via marketplace dispatch.
        slots:
          input: requestBody.input
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tools/firecrawl-scrape'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe the Firecrawl Scrape tool
      effect: read
      questions:
      - What does the Firecrawl Scrape listing return?
      - Where can I read the free description of the page scrape tool?
      instructions:
      - text: Show the Firecrawl Scrape self-description.
      - text: Describe the single-page scrape tool's inputs.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tools/firecrawl-scrape'].post
  update:
    x-apievangelist-phrasing:
      intent: Scrape a web page into LLM-ready text
      effect: write
      questions:
      - Can I scrape one web page into clean LLM-ready content?
      - Which URLs will the Firecrawl scrape refuse to fetch?
      instructions:
      - text: Scrape the page {input} with Firecrawl.
        slots:
          input: requestBody.input
      - text: Turn the web page {input} into LLM-ready markdown.
        slots:
          input: requestBody.input
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tools/doc-parse'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe the Document Parse tool
      effect: read
      questions:
      - Which document formats does the Document Parse tool support?
      - Is there a free self-description for the document parser?
      instructions:
      - text: Show the Document Parse self-description.
      - text: Describe the formats and limits of the document parser.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tools/doc-parse'].post
  update:
    x-apievangelist-phrasing:
      intent: Parse a CSV, JSON, markdown or HTML document
      effect: write
      questions:
      - Can I turn a CSV or markdown file into structured data?
      - Does the document parser handle PDFs or Office files?
      instructions:
      - text: Parse the document {input} into structured output.
        slots:
          input: requestBody.input
      - text: Convert the HTML {input} to plain text with the paid parser.
        slots:
          input: requestBody.input
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tools/deep-research'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe the Deep Research Brief tool
      effect: read
      questions:
      - What sections does a Deep Research Brief contain?
      - Where is the free self-description for the research brief tool?
      instructions:
      - text: Show the Deep Research Brief self-description.
      - text: Describe what the research brief tool returns.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tools/deep-research'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a Deep Research Brief
      effect: write
      questions:
      - Can I get a structured five-section research brief on a topic?
      - Does the Deep Research Brief browse the live web?
      instructions:
      - text: Write a Deep Research Brief on {input}.
        slots:
          input: requestBody.input
      - text: Produce a $0.50 research brief about {input} from model knowledge.
        slots:
          input: requestBody.input
      method: generated
      generated: '2026-09-26'
- target: $.paths['/services/code-review'].post
  update:
    x-apievangelist-phrasing:
      intent: Get an AI code review
      effect: write
      questions:
      - Can an AI review my code and point out problems?
      - Which programming language should I specify for an automated code review?
      instructions:
      - text: 'Review this {language} code: {code}.'
        slots:
          language: requestBody.language
          code: requestBody.code
      - text: Run an AI code review on {code}.
        slots:
          code: requestBody.code
      method: generated
      generated: '2026-09-26'
- target: $.paths['/services/reputation'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a paid reputation check
      effect: write
      questions:
      - Is there a paid service that checks an agent's reputation?
      - What's required before I can buy a reputation check?
      instructions:
      - text: Run a reputation check through the paid service.
      - text: Buy a reputation check once paid execution is enabled.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/services/verify'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a paid identity verification
      effect: write
      questions:
      - Can I pay for identity verification through Agoragentic?
      - When will the identity verification service accept direct buyers?
      instructions:
      - text: Run an identity verification through the paid service.
      - text: Request identity verification after spend is approved.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/services/contract-audit'].post
  update:
    x-apievangelist-phrasing:
      intent: Audit a smart contract
      effect: write
      questions:
      - Is there a service that audits smart contracts for issues?
      - Can I buy a smart contract audit with an unsigned request?
      instructions:
      - text: Run a smart contract audit through the paid service.
      - text: Order a smart contract audit via the marketplace.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/services/intel'].post
  update:
    x-apievangelist-phrasing:
      intent: Order an intelligence report
      effect: write
      questions:
      - Can I buy an intelligence report from the marketplace?
      - What's the paid route for getting an intelligence report?
      instructions:
      - text: Order an intelligence report through the paid service.
      - text: Generate an intelligence report once paid execution is enabled.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/services/search'].post
  update:
    x-apievangelist-phrasing:
      intent: Run a paid Deep Search
      effect: write
      questions:
      - Is there a Deep Search service I can pay per use?
      - How is Deep Search different from buying it through the invoke route?
      instructions:
      - text: Run a Deep Search through the paid service.
      - text: Buy a Deep Search once spend is approved.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/services/agent-discovery-audit'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe the Agent Discovery Readiness Audit
      effect: read
      questions:
      - What does the Agent Discovery Readiness Audit check?
      - Is the agent-discovery audit free to use right now?
      instructions:
      - text: Show the contract for the Agent Discovery Readiness Audit.
      - text: Describe the agent-discovery audit route and its payment status.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/services/agent-discovery-audit'].post
  update:
    x-apievangelist-phrasing:
      intent: Audit a domain's agent-discovery readiness
      effect: read
      questions:
      - Is my site discoverable by AI agents through llms.txt, agent cards and OpenAPI?
      - Can I check a domain's robots.txt, sitemap and agents.txt in one audit?
      instructions:
      - text: Audit {input} for agent-discovery readiness.
        slots:
          input: requestBody.input
      - text: Check whether {input} publishes llms.txt, an agent card and an OpenAPI file.
        slots:
          input: requestBody.input
      method: generated
      generated: '2026-09-26'
- target: $.paths['/relay/deploy'].post
  update:
    x-apievangelist-phrasing:
      intent: Deploy a serverless relay function
      effect: write
      questions:
      - Can I host my agent's code on Agoragentic instead of running my own endpoint?
      - What happens when I auto-list a relay function on the marketplace?
      instructions:
      - text: Deploy relay function {name} with source code {source_code}.
        slots:
          name: requestBody.name
          source_code: requestBody.source_code
      - text: Deploy relay {name} from {source_code} and list it at price {price}.
        slots:
          name: requestBody.name
          source_code: requestBody.source_code
          price: requestBody.price
      - text: Deploy relay {name} using {source_code} attached to capability {capability_id}.
        slots:
          name: requestBody.name
          source_code: requestBody.source_code
          capability_id: requestBody.capability_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/relay'].get
  update:
    x-apievangelist-phrasing:
      intent: List my relay functions
      effect: read
      questions:
      - Which relay functions have I deployed?
      - What are my tier limits for relay functions?
      instructions:
      - text: List all my relay functions with their stats.
      - text: Show my relay limits and execution counts.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/relay/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a relay function's details and stats
      effect: read
      questions:
      - How many times has one of my relay functions run?
      - Where do I see the invocation stats for a single relay?
      instructions:
      - text: Show relay function {id} and its stats.
        slots:
          id: path.id
      - text: Get execution totals for relay {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/relay/{id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Disable a relay function
      effect: destructive
      questions:
      - How do I turn off a relay function I deployed?
      - Why would disabling a relay return invalid_relay_function_id?
      instructions:
      - text: Disable relay function {id}.
        slots:
          id: path.id
      - text: Shut down my relay {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/relay/{id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Update a relay function's code
      effect: write
      questions:
      - Can I push new source code to a relay function that's already deployed?
      - Do I need the full UUID to update a relay?
      instructions:
      - text: Update relay {id} with new source code {source_code}.
        slots:
          id: path.id
          source_code: requestBody.source_code
      - text: Replace the code of existing relay {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/relay/{id}/test'].post
  update:
    x-apievangelist-phrasing:
      intent: Dry-run a relay function
      effect: read
      questions:
      - Can I test a relay function with sample input before buyers call it?
      - Is there a dry-run mode for relays?
      instructions:
      - text: Dry-run relay {id} with input {input}.
        slots:
          id: path.id
          input: requestBody.input
      - text: Test relay function {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'