Marketplace API Reference

All Marketplace endpoints are prefixed with /api/v1/agent/founder/marketplace/ and require JWT authentication with a founder-authorized role.

Base URL

Production:  https://api.olympuscloud.ai/api/v1/agent/founder/marketplace
Development: https://dev.api.olympuscloud.ai/api/v1/agent/founder/marketplace

Endpoints

List Marketplace Listings

Browse and search the marketplace catalog.

GET /marketplace/listings

Query Parameters:

Parameter	Type	Description
type	string	Filter by type: agent, app, integration
category	string	Filter by category (e.g., accounting, marketing)
industry	string	Filter by industry tag
search	string	Full-text search
sort	string	Sort by: popular, rating, newest, price
page	int	Page number (default: 1)
per_page	int	Results per page (default: 20, max: 50)

Response:

{
  "listings": [
    {
      "id": "lst_uuid",
      "type": "agent",
      "name": "Restaurant Health Inspector Prep",
      "description": "Monthly compliance checklist, photo documentation, training reminders",
      "category": "compliance",
      "industry_tags": ["restaurant", "food_service"],
      "icon_url": "https://cdn.olympuscloud.ai/marketplace/icons/health-inspector.png",
      "version": "1.2.0",
      "pricing_model": "monthly",
      "price_cents": 2999,
      "install_count": 142,
      "avg_rating": 4.6,
      "publisher": {
        "name": "ComplianceAI",
        "verified": true
      }
    }
  ],
  "meta": {
    "total": 87,
    "page": 1,
    "per_page": 20
  }
}

Get Listing Detail

GET /marketplace/listings/{id}

Response: Full listing detail including screenshots, capabilities, reviews, and compatibility information.

Install Agent/App/Integration

POST /marketplace/install

Request:

{
  "listing_id": "lst_uuid",
  "config": {
    "budget_cents_per_day": 500,
    "autonomy_level": 3
  }
}

Response:

{
  "install_id": "inst_uuid",
  "listing_id": "lst_uuid",
  "status": "active",
  "installed_at": "2026-02-28T10:00:00Z"
}

Uninstall

DELETE /marketplace/install/{id}

Submit Review

POST /marketplace/review

Request:

{
  "listing_id": "lst_uuid",
  "rating": 5,
  "review_text": "Excellent agent for restaurant compliance. Saved us hours per month."
}

List Installed Items

GET /marketplace/installed

Returns all agents, apps, and integrations installed for the current tenant.

AI Recommendations

GET /marketplace/recommendations

Returns AI-recommended marketplace items based on the company's industry, size, current products, and usage patterns.

Error Responses

Code	HTTP Status	Description
LISTING_NOT_FOUND	404	Marketplace listing not found
ALREADY_INSTALLED	409	Item already installed for this tenant
INCOMPATIBLE_TIER	422	Listing not compatible with company tier
BUDGET_EXCEEDED	422	Agent would exceed daily ACP budget

Related Documentation

• Marketplace Guide — Marketplace user guide
• Founder API Reference — All Founder endpoints