# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Relevance AI Endpoints Marketplace API
  version: 1.0.0
extends: openapi/relevance-ai-marketplace-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['/marketplace/{listing_display_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a marketplace listing
      effect: destructive
      questions:
      - How do I take down a listing I put on the Relevance AI marketplace?
      - Is deleting a marketplace listing permanent?
      instructions:
      - text: Delete marketplace listing {listing_display_id}.
        slots:
          listing_display_id: path.listing_display_id
      - text: Remove my listing {listing_display_id} from the marketplace.
        slots:
          listing_display_id: path.listing_display_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/{listing_display_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit a marketplace listing
      effect: write
      questions:
      - How do I change the price or description of my marketplace listing?
      - Can I add a YouTube demo video to a listing I already submitted?
      instructions:
      - text: Set the price of listing {listing_display_id} to {price_usd_cents} cents.
        slots:
          listing_display_id: path.listing_display_id
          price_usd_cents: requestBody.price_usd_cents
      - text: Update the description of listing {listing_display_id} to {description}.
        slots:
          listing_display_id: path.listing_display_id
          description: requestBody.description
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/{listing_display_id}/approve'].post
  update:
    x-apievangelist-phrasing:
      intent: Approve a marketplace listing
      effect: write
      questions:
      - How does a reviewer approve a listing waiting for marketplace review?
      - Can an approval override an earlier review decision?
      instructions:
      - text: Approve marketplace listing {listing_display_id}.
        slots:
          listing_display_id: path.listing_display_id
      - text: Approve listing {listing_display_id} with override {override}.
        slots:
          listing_display_id: path.listing_display_id
          override: requestBody.override
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/{listing_display_id}/reject'].post
  update:
    x-apievangelist-phrasing:
      intent: Reject a marketplace listing
      effect: write
      questions:
      - How do I reject a submitted marketplace listing and say why?
      - Does rejecting a listing require a reason?
      instructions:
      - text: Reject listing {listing_display_id} because {reason}.
        slots:
          listing_display_id: path.listing_display_id
          reason: requestBody.reason
      - text: Decline marketplace submission {listing_display_id} with reason {reason}.
        slots:
          listing_display_id: path.listing_display_id
          reason: requestBody.reason
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/{listing_display_id}/clone'].post
  update:
    x-apievangelist-phrasing:
      intent: Clone a marketplace listing into my project
      effect: write
      questions:
      - How do I copy an agent or tool from the marketplace into my own project?
      - Can I choose which version of a listing to clone?
      instructions:
      - text: Clone marketplace listing {listing_display_id}.
        slots:
          listing_display_id: path.listing_display_id
      - text: Clone the {version_type} version of listing {listing_display_id}.
        slots:
          version_type: requestBody.version_type
          listing_display_id: path.listing_display_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/submit'].post
  update:
    x-apievangelist-phrasing:
      intent: Submit a new listing to the marketplace
      effect: write
      questions:
      - How do I publish my agent or tool as a new marketplace listing?
      - What do I need to provide when submitting something to the marketplace?
      instructions:
      - text: Submit {entity_type} {entity_display_id} version {entity_version_display_id} to the marketplace as {name}.
        slots:
          entity_type: requestBody.entity_type
          entity_display_id: requestBody.entity_display_id
          entity_version_display_id: requestBody.entity_version_display_id
          name: requestBody.name
      - text: List {name} on the marketplace for {price_usd_cents} cents.
        slots:
          name: requestBody.name
          price_usd_cents: requestBody.price_usd_cents
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/{listing_display_id}/version'].post
  update:
    x-apievangelist-phrasing:
      intent: Publish a new version of a listing
      effect: write
      questions:
      - How do I push an updated version of my agent to an existing marketplace listing?
      - Can a marketplace listing have multiple versions?
      instructions:
      - text: Create a new version of listing {listing_display_id} from {entity_type} {entity_display_id} version {entity_version_display_id}.
        slots:
          listing_display_id: path.listing_display_id
          entity_type: requestBody.entity_type
          entity_display_id: requestBody.entity_display_id
          entity_version_display_id: requestBody.entity_version_display_id
      - text: Add version {entity_version_display_id} of {entity_type} {entity_display_id} to listing {listing_display_id}.
        slots:
          entity_version_display_id: requestBody.entity_version_display_id
          entity_type: requestBody.entity_type
          entity_display_id: requestBody.entity_display_id
          listing_display_id: path.listing_display_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/my-listings'].get
  update:
    x-apievangelist-phrasing:
      intent: List my own marketplace listings
      effect: read
      questions:
      - Which marketplace listings has my project submitted?
      - Can I see which of my listings are still pending approval?
      instructions:
      - text: List my marketplace listings.
      - text: Show my listings with approval status {approvalStatus}.
        slots:
          approvalStatus: query.approvalStatus
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/listings'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse published marketplace listings
      effect: read
      questions:
      - What agents and tools are published on the marketplace?
      - Can I filter marketplace listings by category and price range?
      instructions:
      - text: Browse published marketplace listings in {category}.
        slots:
          category: query.category
      - text: Search the marketplace for {searchQuery} priced under {maxPrice}.
        slots:
          searchQuery: query.searchQuery
          maxPrice: query.maxPrice
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/listings/{listing_display_id}/published'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the published version of a listing
      effect: read
      questions:
      - How do I see exactly what's currently live for a marketplace listing?
      - Which version of a listing are buyers seeing right now?
      instructions:
      - text: Get the published version of listing {listing_display_id}.
        slots:
          listing_display_id: path.listing_display_id
      - text: Show what's live on the marketplace for {listing_display_id}.
        slots:
          listing_display_id: path.listing_display_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/listings/pending-versions'].get
  update:
    x-apievangelist-phrasing:
      intent: Get pending versions of listings
      effect: read
      questions:
      - Which of my listings have new versions waiting for review?
      - Can I check pending versions for several listings at once?
      instructions:
      - text: Get pending versions for listings {listing_display_ids}.
        slots:
          listing_display_ids: query.listing_display_ids
      - text: Show unreviewed versions of listings {listing_display_ids}.
        slots:
          listing_display_ids: query.listing_display_ids
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/listings/{listing_display_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a marketplace listing's base details
      effect: read
      questions:
      - How do I fetch a listing's base data by its listing id?
      - Can I view my own unpublished listing by its id?
      instructions:
      - text: Get marketplace listing {listing_display_id}.
        slots:
          listing_display_id: path.listing_display_id
      - text: Show the base details of listing {listing_display_id}.
        slots:
          listing_display_id: path.listing_display_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/listings/entity/{entity_display_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Find a listing by its agent or tool id
      effect: read
      questions:
      - Is my agent already listed on the marketplace?
      - How do I find the listing for a specific agent or tool id?
      instructions:
      - text: Find the marketplace listing for entity {entity_display_id}.
        slots:
          entity_display_id: path.entity_display_id
      - text: Get the listing that sells agent {entity_display_id}.
        slots:
          entity_display_id: path.entity_display_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/builders/{project_display_id}/stripe'].post
  update:
    x-apievangelist-phrasing:
      intent: Connect a Stripe account for payouts
      effect: write
      questions:
      - How do I get paid for selling listings on the marketplace?
      - Which details are needed to link a Stripe account as a builder?
      instructions:
      - text: Link a Stripe account to builder {project_display_id} in {country_code} as a {business_type}.
        slots:
          project_display_id: path.project_display_id
          country_code: requestBody.country_code
          business_type: requestBody.business_type
      - text: Set up Stripe payouts for builder {project_display_id} in country {country_code} for business type {business_type}.
        slots:
          project_display_id: path.project_display_id
          country_code: requestBody.country_code
          business_type: requestBody.business_type
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/builders'].get
  update:
    x-apievangelist-phrasing:
      intent: List marketplace builders
      effect: read
      questions:
      - Who are the builders publishing on the marketplace?
      - Can I search marketplace builders by name?
      instructions:
      - text: List marketplace builders.
      - text: Search builders for {searchQuery}.
        slots:
          searchQuery: query.searchQuery
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/builders'].post
  update:
    x-apievangelist-phrasing:
      intent: Create or update my builder profile
      effect: write
      questions:
      - How do I set up a builder profile to sell on the marketplace?
      - Can I change my builder bio and profile picture?
      instructions:
      - text: Create builder profile {name} for project {project_display_id}.
        slots:
          name: requestBody.name
          project_display_id: requestBody.project_display_id
      - text: Update the bio of builder {project_display_id} to {bio}.
        slots:
          project_display_id: requestBody.project_display_id
          bio: requestBody.bio
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/builders/upload-image'].post
  update:
    x-apievangelist-phrasing:
      intent: Upload a marketplace image
      effect: write
      questions:
      - What size limits apply to marketplace profile and cover images?
      - How do I upload an image for a marketplace listing?
      instructions:
      - text: Upload image {image_base64} as a {image_type} image.
        slots:
          image_base64: requestBody.image_base64
          image_type: requestBody.image_type
      - text: Upload {image_base64} for listing {listing_display_id}.
        slots:
          image_base64: requestBody.image_base64
          listing_display_id: requestBody.listing_display_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/listings/{listing_display_id}/assets'].delete
  update:
    x-apievangelist-phrasing:
      intent: Remove an asset from a listing
      effect: destructive
      questions:
      - How do I remove a screenshot from my marketplace listing?
      - Does deleting a listing asset also delete the stored image?
      instructions:
      - text: Delete asset {asset_id} from listing {listing_display_id}.
        slots:
          asset_id: requestBody.asset_id
          listing_display_id: path.listing_display_id
      - text: Remove image {asset_id} from marketplace listing {listing_display_id}.
        slots:
          asset_id: requestBody.asset_id
          listing_display_id: path.listing_display_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/builders/{project_display_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a builder's profile
      effect: read
      questions:
      - How do I view a marketplace builder's profile?
      - What does a builder's profile show about them?
      instructions:
      - text: Get builder {project_display_id}.
        slots:
          project_display_id: path.project_display_id
      - text: Show the profile of builder {project_display_id}.
        slots:
          project_display_id: path.project_display_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/{listing_display_id}/publish'].post
  update:
    x-apievangelist-phrasing:
      intent: Publish or unpublish a listing
      effect: write
      questions:
      - How do I hide an approved listing from the marketplace without deleting it?
      - Can I make an approved listing go live?
      instructions:
      - text: Set listing {listing_display_id} published to {published}.
        slots:
          listing_display_id: path.listing_display_id
          published: requestBody.published
      - text: Unpublish marketplace listing {listing_display_id} by setting published to {published}.
        slots:
          listing_display_id: path.listing_display_id
          published: requestBody.published
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/purchases/checkout'].post
  update:
    x-apievangelist-phrasing:
      intent: Start checkout to buy a listing
      effect: write
      questions:
      - How do I buy a paid agent from the marketplace?
      - Can I get a checkout link for a marketplace listing?
      instructions:
      - text: Create a checkout session for listing {listing_display_id}.
        slots:
          listing_display_id: requestBody.listing_display_id
      - text: Start buying marketplace listing {listing_display_id}.
        slots:
          listing_display_id: requestBody.listing_display_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/purchases/{project_display_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: List my project's marketplace purchases
      effect: read
      questions:
      - What has my project bought from the marketplace?
      - Where can I see all marketplace purchases for a project?
      instructions:
      - text: List marketplace purchases for project {project_display_id}.
        slots:
          project_display_id: path.project_display_id
      - text: Show everything project {project_display_id} has purchased.
        slots:
          project_display_id: path.project_display_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/purchases/{project_display_id}/{listing_display_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Check a purchase of one listing
      effect: read
      questions:
      - Has my project already bought a particular listing?
      - How do I look up a single marketplace purchase?
      instructions:
      - text: Get the purchase of listing {listing_display_id} by project {project_display_id}.
        slots:
          listing_display_id: path.listing_display_id
          project_display_id: path.project_display_id
      - text: Check whether project {project_display_id} owns listing {listing_display_id}.
        slots:
          project_display_id: path.project_display_id
          listing_display_id: path.listing_display_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/public/listings'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse marketplace listings without signing in
      effect: read
      questions:
      - Is there a public, unauthenticated way to browse marketplace listings?
      - Can a public website list marketplace agents by category?
      instructions:
      - text: Browse the public marketplace catalog for {searchQuery}.
        slots:
          searchQuery: query.searchQuery
      - text: List public marketplace listings of type {entityType} without auth.
        slots:
          entityType: query.entityType
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/public/listings/{listing_display_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a published listing without signing in
      effect: read
      questions:
      - Can I show one marketplace listing on a public page without authentication?
      - Is there an unauthenticated endpoint for a single published listing?
      instructions:
      - text: Get public listing {listing_display_id} without auth.
        slots:
          listing_display_id: path.listing_display_id
      - text: Fetch the public page data for marketplace listing {listing_display_id}.
        slots:
          listing_display_id: path.listing_display_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/listings/{listing_display_id}/reviews'].get
  update:
    x-apievangelist-phrasing:
      intent: Read reviews of a listing
      effect: read
      questions:
      - What are people saying about a marketplace listing?
      - How do I see all reviews left on a listing?
      instructions:
      - text: Get the reviews for listing {listing_display_id}.
        slots:
          listing_display_id: path.listing_display_id
      - text: Show buyer ratings on marketplace listing {listing_display_id}.
        slots:
          listing_display_id: path.listing_display_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/listings/{listing_display_id}/reviews'].post
  update:
    x-apievangelist-phrasing:
      intent: Review a marketplace listing
      effect: write
      questions:
      - How do I leave a star rating on a marketplace listing?
      - Can I add a comment along with my rating?
      instructions:
      - text: Rate listing {listing_display_id} {rating} stars.
        slots:
          listing_display_id: path.listing_display_id
          rating: requestBody.rating
      - text: Review listing {listing_display_id} with rating {rating} and comment {comment}.
        slots:
          listing_display_id: path.listing_display_id
          rating: requestBody.rating
          comment: requestBody.comment
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/reviews/my-reviews'].get
  update:
    x-apievangelist-phrasing:
      intent: List reviews I have written
      effect: read
      questions:
      - Which marketplace reviews have I written?
      - Where can I find all my own ratings of listings?
      instructions:
      - text: List all the reviews I've written.
      - text: Show my own marketplace ratings.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/listings/{listing_display_id}/reviews/{listing_review_id}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a review on a listing
      effect: destructive
      questions:
      - How do I delete a review I left on a listing?
      - Can a review be removed from a marketplace listing?
      instructions:
      - text: Delete review {listing_review_id} on listing {listing_display_id}.
        slots:
          listing_review_id: path.listing_review_id
          listing_display_id: path.listing_display_id
      - text: Remove my review {listing_review_id} from {listing_display_id}.
        slots:
          listing_review_id: path.listing_review_id
          listing_display_id: path.listing_display_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/listings/{listing_display_id}/reviews/{listing_review_id}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Edit a review on a listing
      effect: write
      questions:
      - How do I change the rating on a review I already posted?
      - Can I edit the title or comment of my listing review?
      instructions:
      - text: Change review {listing_review_id} on {listing_display_id} to {rating} stars.
        slots:
          listing_review_id: path.listing_review_id
          listing_display_id: path.listing_display_id
          rating: requestBody.rating
      - text: Edit the comment on review {listing_review_id} of listing {listing_display_id} to {comment}.
        slots:
          listing_review_id: path.listing_review_id
          listing_display_id: path.listing_display_id
          comment: requestBody.comment
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/listings/{listing_display_id}/reviews/{listing_review_id}/publisher-reply'].put
  update:
    x-apievangelist-phrasing:
      intent: Reply to a review as the publisher
      effect: write
      questions:
      - How do I respond publicly to a review of my listing?
      - Can a publisher reply to buyer reviews?
      instructions:
      - text: Reply {publisher_reply} to review {listing_review_id} on {listing_display_id}.
        slots:
          publisher_reply: requestBody.publisher_reply
          listing_review_id: path.listing_review_id
          listing_display_id: path.listing_display_id
      - text: Post publisher reply {publisher_reply} on review {listing_review_id} of my listing {listing_display_id}.
        slots:
          publisher_reply: requestBody.publisher_reply
          listing_review_id: path.listing_review_id
          listing_display_id: path.listing_display_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/marketplace/reviews/on-my-listings'].get
  update:
    x-apievangelist-phrasing:
      intent: List reviews on my listings
      effect: read
      questions:
      - What reviews have buyers left on the listings I publish?
      - Can I see only the reviews I haven't replied to yet?
      instructions:
      - text: List reviews on my listings.
      - text: Show reviews on my listings with ratings {ratings} and replied {replied}.
        slots:
          ratings: query.ratings
          replied: query.replied
      method: generated
      generated: '2026-09-26'