eBay Inventory API — Inventory_item_group

naftiko: 1.0.0-alpha2
info:
  label: eBay Inventory API — Inventory_item_group
  description: 'eBay Inventory API — Inventory_item_group. 3 operations. Lead operation: Inventory_item_group. Self-contained
    Naftiko capability covering one Ebay business surface.'
  tags:
  - Ebay
  - Inventory_item_group
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    EBAY_API_KEY: EBAY_API_KEY
capability:
  consumes:
  - type: http
    namespace: inventory-inventory-item-group
    baseUri: https://api.ebay.com{basePath}
    description: eBay Inventory API — Inventory_item_group business capability. Self-contained, no shared references.
    resources:
    - name: inventory_item_group-inventoryItemGroupKey
      path: /inventory_item_group/{inventoryItemGroupKey}
      operations:
      - name: getinventoryitemgroup
        method: GET
        description: This call retrieves the inventory item group for a given <strong>inventoryItemGroupKey</strong> value.
          The <strong>inventoryItemGroupKey</strong> value is passed in at the end of the call URI.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: inventoryItemGroupKey
          in: path
          type: string
          description: This path parameter specifies the unique identifier of the inventory item group being retrieved. This
            value is assigned by the seller when an inventory item gro
          required: true
      - name: createorreplaceinventoryitemgroup
        method: PUT
        description: <span class="tablenote"><strong>Note:</strong> Each listing can be revised up to 250 times in one calendar
          day. If this revision threshold is reached, the seller will be blocked from revising the item until the next calendar
          day.</span><br>
        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: inventoryItemGroupKey
          in: path
          type: string
          description: 'This path parameter specifies the unique identifier of the inventory item group being created or updated.
            This identifier is defined by the seller.<br><br>This '
          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: deleteinventoryitemgroup
        method: DELETE
        description: This call deletes the inventory item group for a given <strong>inventoryItemGroupKey</strong> value.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: inventoryItemGroupKey
          in: path
          type: string
          description: This path parameter specifies the unique identifier of the inventory item group being deleted. This
            value is assigned by the seller when an inventory item group
          required: true
    authentication:
      type: bearer
      token: '{{env.EBAY_API_KEY}}'
  exposes:
  - type: rest
    namespace: inventory-inventory-item-group-rest
    port: 8080
    description: REST adapter for eBay Inventory API — Inventory_item_group. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/inventory-item-group/{inventoryitemgroupkey}
      name: inventory-item-group-inventoryitemgroupkey
      description: REST surface for inventory_item_group-inventoryItemGroupKey.
      operations:
      - method: GET
        name: getinventoryitemgroup
        description: This call retrieves the inventory item group for a given <strong>inventoryItemGroupKey</strong> value.
          The <strong>inventoryItemGroupKey</strong> value is passed in at the end of the call URI.
        call: inventory-inventory-item-group.getinventoryitemgroup
        with:
          inventoryItemGroupKey: rest.inventoryItemGroupKey
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: createorreplaceinventoryitemgroup
        description: <span class="tablenote"><strong>Note:</strong> Each listing can be revised up to 250 times in one calendar
          day. If this revision threshold is reached, the seller will be blocked from revising the item until the next calendar
          day.</span><br>
        call: inventory-inventory-item-group.createorreplaceinventoryitemgroup
        with:
          Content-Language: rest.Content-Language
          inventoryItemGroupKey: rest.inventoryItemGroupKey
          Content-Type: rest.Content-Type
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteinventoryitemgroup
        description: This call deletes the inventory item group for a given <strong>inventoryItemGroupKey</strong> value.
        call: inventory-inventory-item-group.deleteinventoryitemgroup
        with:
          inventoryItemGroupKey: rest.inventoryItemGroupKey
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: inventory-inventory-item-group-mcp
    port: 9090
    transport: http
    description: MCP adapter for eBay Inventory API — Inventory_item_group. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: this-call-retrieves-inventory-item
      description: This call retrieves the inventory item group for a given <strong>inventoryItemGroupKey</strong> value.
        The <strong>inventoryItemGroupKey</strong> value is passed in at the end of the call URI.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: inventory-inventory-item-group.getinventoryitemgroup
      with:
        inventoryItemGroupKey: tools.inventoryItemGroupKey
      outputParameters:
      - type: object
        mapping: $.
    - name: span-class-tablenote-strong-note-strong-each-listing
      description: <span class="tablenote"><strong>Note:</strong> Each listing can be revised up to 250 times in one calendar
        day. If this revision threshold is reached, the seller will be blocked from revising the item until the next calendar
        day.</span><br>
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: inventory-inventory-item-group.createorreplaceinventoryitemgroup
      with:
        Content-Language: tools.Content-Language
        inventoryItemGroupKey: tools.inventoryItemGroupKey
        Content-Type: tools.Content-Type
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: this-call-deletes-inventory-item
      description: This call deletes the inventory item group for a given <strong>inventoryItemGroupKey</strong> value.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: inventory-inventory-item-group.deleteinventoryitemgroup
      with:
        inventoryItemGroupKey: tools.inventoryItemGroupKey
      outputParameters:
      - type: object
        mapping: $.