openapi: 3.2.0
info:
  title: Karada Marketplace API
  version: 1.0.0
  description: Spec-Driven API definition for Karada MCP Platform
servers:
- url: https://api.karada.ai
  description: Production API
- url: http://localhost:8080
  description: Local development API
tags:
- name: Marketplace
paths:
  /api/v1/marketplace/projects:
    get:
      summary: List public projects in marketplace
      operationId: getMarketplaceProjects
      tags:
      - Marketplace
      responses:
        '200':
          description: List of public projects
  /api/v1/marketplace/listings:
    get:
      summary: List marketplace listings
      operationId: getMarketplaceListings
      tags:
      - Marketplace
      responses:
        '200':
          description: Marketplace listings
  /api/v1/marketplace/listings/{id}:
    get:
      summary: Get marketplace listing detail
      operationId: getMarketplaceListing
      tags:
      - Marketplace
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Listing detail
    put:
      summary: Update marketplace listing
      operationId: updateMarketplaceListing
      tags:
      - Marketplace
      security:
      - BearerAuth: []
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Listing updated
  /api/v1/marketplace/claim:
    post:
      summary: Submit claim request for marketplace listing
      operationId: submitMarketplaceClaim
      tags:
      - Marketplace
      security:
      - BearerAuth: []
      responses:
        '201':
          description: Claim submitted
  /api/v1/marketplace/my-listings:
    get:
      summary: Get caller's marketplace listings
      operationId: getMyMarketplaceListings
      tags:
      - Marketplace
      security:
      - BearerAuth: []
      responses:
        '200':
          description: Caller's listings
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT