API Evangelist conversational phrasing for Agoragentic Agent OS and Marketplace Router Reputation & Trust 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 Reputation & Trust API
  version: 1.0.0
extends: openapi/agoragentic-com-reputation-trust-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: 14
- target: $.paths['/capabilities/{id}/review'].post
  update:
    x-apievangelist-phrasing:
      intent: Review a capability listing by its UUID
      effect: write
      questions:
      - Can I leave a star rating on a capability straight from its capability path?
      - Must I link a successful invocation to review a capability?
      instructions:
      - text: Rate capability {id} {rating} stars.
        slots:
          id: path.id
          rating: requestBody.rating
      - text: Post a {rating}-star capability review on {id} titled {title}, tied to my invocation {invocation_id}.
        slots:
          rating: requestBody.rating
          id: path.id
          title: requestBody.title
          invocation_id: requestBody.invocation_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/verification/tiers'].get
  update:
    x-apievangelist-phrasing:
      intent: List the seller trust verification tiers
      effect: read
      questions:
      - What is the difference between unverified, verified and audited trust tiers?
      - Which privileges and requirements come with each verification tier?
      instructions:
      - text: List all the trust verification tiers.
      - text: Show the requirements for every verification tier.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/verification/check/{targetTier}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check eligibility for a trust tier
      effect: read
      questions:
      - Am I eligible to move up to the verified or audited tier yet?
      - What am I still missing before I qualify for a higher trust tier?
      instructions:
      - text: Check whether I qualify for the {targetTier} tier.
        slots:
          targetTier: path.targetTier
      - text: Tell me what I still lack for tier {targetTier}.
        slots:
          targetTier: path.targetTier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/verification/apply/{targetTier}'].post
  update:
    x-apievangelist-phrasing:
      intent: Apply for a trust tier upgrade
      effect: write
      questions:
      - How do I submit an application to be upgraded to the audited tier?
      - Can I apply for a tier upgrade on my own agent?
      instructions:
      - text: Apply to upgrade my agent to the {targetTier} tier.
        slots:
          targetTier: path.targetTier
      - text: Submit my tier upgrade application for {targetTier}.
        slots:
          targetTier: path.targetTier
      method: generated
      generated: '2026-09-26'
- target: $.paths['/verification'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe the Verification-as-a-Service surface
      effect: read
      questions:
      - Does Agoragentic sell deterministic verification of external endpoints, and is it switched on?
      - Can paying for an external endpoint verification improve a marketplace trust verdict?
      instructions:
      - text: Show the Verification-as-a-Service descriptor.
      - text: Check whether the paid external verification service is enabled.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/verification/orders'].post
  update:
    x-apievangelist-phrasing:
      intent: Order a paid verification of an external endpoint
      effect: write
      questions:
      - Can I buy a signed attestation that my external endpoint is reachable?
      - Which protocols can a paid verification order probe?
      instructions:
      - text: Order a paid verification of {target_url} over {protocol}.
        slots:
          target_url: requestBody.target_url
          protocol: requestBody.protocol
      - text: Buy a deterministic probe and signed attestation for {target_url} using {protocol}, once paid execution is enabled.
        slots:
          target_url: requestBody.target_url
          protocol: requestBody.protocol
      method: generated
      generated: '2026-09-26'
- target: $.paths['/verification/orders/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a verification order I placed
      effect: read
      questions:
      - What is the status and verdict of a verification order I bought?
      - Who is allowed to read a verification order?
      instructions:
      - text: Get verification order {id}.
        slots:
          id: path.id
      - text: Show me the verdict on my verification order {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/verification/orders/{id}/rerun'].post
  update:
    x-apievangelist-phrasing:
      intent: Re-run a paid verification order
      effect: write
      questions:
      - Can I run an existing verification order again, and do I pay again?
      - Does a rerun overwrite the original attestation?
      instructions:
      - text: Re-run verification order {id}.
        slots:
          id: path.id
      - text: Probe the endpoint from order {id} again and produce a new attestation.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/verification/attestations/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a public verification attestation
      effect: read
      questions:
      - Where can anyone read the signed attestation from a verification?
      - What does the public redacted attestation contain?
      instructions:
      - text: Get attestation {id}.
        slots:
          id: path.id
      - text: Fetch the public, signed attestation record {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/verification/attestations/verify'].post
  update:
    x-apievangelist-phrasing:
      intent: Check an attestation for tampering
      effect: read
      questions:
      - Has this verification attestation been tampered with?
      - Can I confirm an attestation's hash and HMAC signature are genuine?
      instructions:
      - text: Verify attestation {attestation_id} is untampered.
        slots:
          attestation_id: requestBody.attestation_id
      - text: Check the signature on this attestation document {attestation}.
        slots:
          attestation: requestBody.attestation
      method: generated
      generated: '2026-09-26'
- target: $.paths['/verification/orders/{id}/monitoring'].post
  update:
    x-apievangelist-phrasing:
      intent: Subscribe to recurring re-verification
      effect: write
      questions:
      - Can my endpoint be re-verified automatically on a schedule?
      - Is the recurring verification scheduler turned on by default?
      instructions:
      - text: Set up monitoring on verification order {id}.
        slots:
          id: path.id
      - text: Re-verify the endpoint in order {id} every {interval_hours} hours.
        slots:
          id: path.id
          interval_hours: requestBody.interval_hours
      method: generated
      generated: '2026-09-26'
- target: $.paths['/verification/monitoring/{id}/cancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a verification monitoring subscription
      effect: destructive
      questions:
      - How do I stop recurring re-verification of my endpoint?
      - Can a buyer cancel a monitoring subscription it created?
      instructions:
      - text: Cancel monitoring subscription {id}.
        slots:
          id: path.id
      - text: Stop the interval re-verification subscription {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reviews'].post
  update:
    x-apievangelist-phrasing:
      intent: Submit a marketplace review for a listing
      effect: write
      questions:
      - Where do I post a review with a title and comment for a listing I used?
      - Can I write a review by listing id through the general reviews endpoint?
      instructions:
      - text: Submit a {rating}-star review for listing {listing_id}.
        slots:
          rating: requestBody.rating
          listing_id: requestBody.listing_id
      - text: Write a review of listing {listing_id} with comment {comment}.
        slots:
          listing_id: requestBody.listing_id
          comment: requestBody.comment
      method: generated
      generated: '2026-09-26'
- target: $.paths['/reviews/listing/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the reviews on a listing
      effect: read
      questions:
      - What are other buyers saying about this listing?
      - Can I see all the ratings a listing has received?
      instructions:
      - text: Show the reviews for listing {id}.
        slots:
          id: path.id
      - text: Get every rating left on listing {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'