# 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'