eBay Inventory API — Product_compatibility

naftiko: 1.0.0-alpha2
info:
  label: eBay Inventory API — Product_compatibility
  description: 'eBay Inventory API — Product_compatibility. 3 operations. Lead operation: Product_compatibility. Self-contained
    Naftiko capability covering one Ebay business surface.'
  tags:
  - Ebay
  - Product_compatibility
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    EBAY_API_KEY: EBAY_API_KEY
capability:
  consumes:
  - type: http
    namespace: inventory-product-compatibility
    baseUri: https://api.ebay.com{basePath}
    description: eBay Inventory API — Product_compatibility business capability. Self-contained, no shared references.
    resources:
    - name: inventory_item-sku-product_compatibility
      path: /inventory_item/{sku}/product_compatibility
      operations:
      - name: getproductcompatibility
        method: GET
        description: This call is used by the seller to retrieve the list of products that are compatible with the inventory
          item. The SKU value for the inventory item is passed into the call URI, and a successful call with return the compatible
          vehicle list as
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: sku
          in: path
          type: string
          description: 'This path parameter specifies the SKU (stock keeping unit) of the inventory item associated with the
            product compatibility list being retrieved.<br><br>Use the '
          required: true
      - name: createorreplaceproductcompatibility
        method: PUT
        description: This call is used by the seller to create or replace a list of products that are compatible with the
          inventory item. The inventory item is identified with a SKU value in the URI. Product compatibility is currently
          only applicable to motor v
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: Content-Language
          in: header
          type: string
          description: This header sets the natural language that will be used in the field values of the request payload.
            For example, the value passed in this header should be <code
          required: true
        - name: sku
          in: path
          type: string
          description: This path parameter specifies the SKU (stock keeping unit) of the inventory item associated with the
            compatibility list being created.<br><br>Use the <a href="/
          required: true
        - name: Content-Type
          in: header
          type: string
          description: 'This header indicates the format of the request body provided by the client. Its value should be set
            to <b>application/json</b>. <br><br> For more information, '
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: deleteproductcompatibility
        method: DELETE
        description: This call is used by the seller to delete the list of products that are compatible with the inventory
          item that is associated with the compatible product list. The inventory item is identified with a SKU value in the
          URI. Product compatibil
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: sku
          in: path
          type: string
          description: This path parameter specifies the SKU (stock keeping unit) of the inventory item that is associated
            with the product compatibility list that is being deleted.<b
          required: true
    authentication:
      type: bearer
      token: '{{env.EBAY_API_KEY}}'
  exposes:
  - type: rest
    namespace: inventory-product-compatibility-rest
    port: 8080
    description: REST adapter for eBay Inventory API — Product_compatibility. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/inventory-item/{sku}/product-compatibility
      name: inventory-item-sku-product-compatibility
      description: REST surface for inventory_item-sku-product_compatibility.
      operations:
      - method: GET
        name: getproductcompatibility
        description: This call is used by the seller to retrieve the list of products that are compatible with the inventory
          item. The SKU value for the inventory item is passed into the call URI, and a successful call with return the compatible
          vehicle list as
        call: inventory-product-compatibility.getproductcompatibility
        with:
          sku: rest.sku
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: createorreplaceproductcompatibility
        description: This call is used by the seller to create or replace a list of products that are compatible with the
          inventory item. The inventory item is identified with a SKU value in the URI. Product compatibility is currently
          only applicable to motor v
        call: inventory-product-compatibility.createorreplaceproductcompatibility
        with:
          Content-Language: rest.Content-Language
          sku: rest.sku
          Content-Type: rest.Content-Type
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteproductcompatibility
        description: This call is used by the seller to delete the list of products that are compatible with the inventory
          item that is associated with the compatible product list. The inventory item is identified with a SKU value in the
          URI. Product compatibil
        call: inventory-product-compatibility.deleteproductcompatibility
        with:
          sku: rest.sku
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: inventory-product-compatibility-mcp
    port: 9090
    transport: http
    description: MCP adapter for eBay Inventory API — Product_compatibility. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: this-call-is-used-seller
      description: This call is used by the seller to retrieve the list of products that are compatible with the inventory
        item. The SKU value for the inventory item is passed into the call URI, and a successful call with return the compatible
        vehicle list as
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: inventory-product-compatibility.getproductcompatibility
      with:
        sku: tools.sku
      outputParameters:
      - type: object
        mapping: $.
    - name: this-call-is-used-seller-2
      description: This call is used by the seller to create or replace a list of products that are compatible with the inventory
        item. The inventory item is identified with a SKU value in the URI. Product compatibility is currently only applicable
        to motor v
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: inventory-product-compatibility.createorreplaceproductcompatibility
      with:
        Content-Language: tools.Content-Language
        sku: tools.sku
        Content-Type: tools.Content-Type
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: this-call-is-used-seller-3
      description: This call is used by the seller to delete the list of products that are compatible with the inventory item
        that is associated with the compatible product list. The inventory item is identified with a SKU value in the URI.
        Product compatibil
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: inventory-product-compatibility.deleteproductcompatibility
      with:
        sku: tools.sku
      outputParameters:
      - type: object
        mapping: $.