naftiko: 1.0.0-alpha2
info:
label: eBay Inventory API — Inventory_item
description: 'eBay Inventory API — Inventory_item. 7 operations. Lead operation: Inventory_item. Self-contained Naftiko
capability covering one Ebay business surface.'
tags:
- Ebay
- Inventory_item
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
baseUri: https://api.ebay.com{basePath}
description: eBay Inventory API — Inventory_item business capability. Self-contained, no shared references.
resources:
- name: bulk_create_or_replace_inventory_item
path: /bulk_create_or_replace_inventory_item
operations:
- name: bulkcreateorreplaceinventoryitem
method: POST
description: Note: Please note that any eBay listing created using the Inventory
API cannot be revised or relisted using the Trading API calls.
Note:
Each listin
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- 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 application/json.
For more information, '
required: true
- 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
Note: In addition to the authorization
head
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- 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 application/json.
For more information, '
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: true
- name: bulk_update_price_quantity
path: /bulk_update_price_quantity
operations:
- name: bulkupdatepricequantity
method: POST
description: This call is used by the seller to update the total ship-to-home quantity of one inventory item, and/or
to update the price and/or quantity of one or more offers associated with one inventory item. Up to 25 offers associated
with an invento
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- 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 application/json.
For more information, '
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: true
- name: inventory_item
path: /inventory_item
operations:
- name: getinventoryitems
method: GET
description: This call retrieves all inventory item records defined for the seller's account. The limit
query parameter allows the seller to control how many records are returned per page, and the offset
query parameter
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: limit
in: query
type: string
description: The value passed in this query parameter sets the maximum number of records to return per page of data.
Although this field is a string, the value passed in thi
- name: offset
in: query
type: string
description: The value passed in this query parameter sets the page number to retrieve. The first page of records
has a value of 0, the second page of records h
- name: inventory_item-sku
path: /inventory_item/{sku}
operations:
- name: getinventoryitem
method: GET
description: This call retrieves the inventory item record for a given SKU. The SKU value is passed in at the end
of the call URI. There is no request payload for this call.
The authorization header is the
only required HTTP header f
outputRawFormat: json
outputParameters:
- name: result
type: object
value: $.
inputParameters:
- name: sku
in: path
type: string
description: This path parameter specifies the seller-defined SKU value of the product whose inventory item record
you wish to retrieve.
Use the Note: Please note that any eBay listing created using the Inventory
API cannot be revised or relisted using the Trading API calls.
Note:
Each listin
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 application/json.
For more information, '
required: true
- name: body
in: body
type: object
description: Request body (JSON).
required: true
- name: deleteinventoryitem
method: DELETE
description: 'This call is used to delete an inventory item record associated with a specified SKU. A successful call
will not only delete that inventory item record, but will also have the following effects:
Note:
Each listin
call: inventory-inventory-item.bulkcreateorreplaceinventoryitem
with:
Content-Type: rest.Content-Type
Content-Language: rest.Content-Language
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/bulk-get-inventory-item
name: bulk-get-inventory-item
description: REST surface for bulk_get_inventory_item.
operations:
- method: POST
name: bulkgetinventoryitem
description: This call retrieves up to 25 inventory item records. The SKU value of each inventory item record to retrieve
is specified in the request payload.
Note: In addition to the authorization
head
call: inventory-inventory-item.bulkgetinventoryitem
with:
Content-Type: rest.Content-Type
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/bulk-update-price-quantity
name: bulk-update-price-quantity
description: REST surface for bulk_update_price_quantity.
operations:
- method: POST
name: bulkupdatepricequantity
description: This call is used by the seller to update the total ship-to-home quantity of one inventory item, and/or
to update the price and/or quantity of one or more offers associated with one inventory item. Up to 25 offers associated
with an invento
call: inventory-inventory-item.bulkupdatepricequantity
with:
Content-Type: rest.Content-Type
body: rest.body
outputParameters:
- type: object
mapping: $.
- path: /v1/inventory-item
name: inventory-item
description: REST surface for inventory_item.
operations:
- method: GET
name: getinventoryitems
description: This call retrieves all inventory item records defined for the seller's account. The limit
query parameter allows the seller to control how many records are returned per page, and the offset
query parameter
call: inventory-inventory-item.getinventoryitems
with:
limit: rest.limit
offset: rest.offset
outputParameters:
- type: object
mapping: $.
- path: /v1/inventory-item/{sku}
name: inventory-item-sku
description: REST surface for inventory_item-sku.
operations:
- method: GET
name: getinventoryitem
description: This call retrieves the inventory item record for a given SKU. The SKU value is passed in at the end
of the call URI. There is no request payload for this call.
The authorization header is the
only required HTTP header f
call: inventory-inventory-item.getinventoryitem
with:
sku: rest.sku
outputParameters:
- type: object
mapping: $.
- method: PUT
name: createorreplaceinventoryitem
description: Note: Please note that any eBay listing created using the Inventory
API cannot be revised or relisted using the Trading API calls.
Note:
Each listin
call: inventory-inventory-item.createorreplaceinventoryitem
with:
Content-Language: rest.Content-Language
sku: rest.sku
Content-Type: rest.Content-Type
body: rest.body
outputParameters:
- type: object
mapping: $.
- method: DELETE
name: deleteinventoryitem
description: 'This call is used to delete an inventory item record associated with a specified SKU. A successful call
will not only delete that inventory item record, but will also have the following effects:- Delete any and
all unpublished offers '
call: inventory-inventory-item.deleteinventoryitem
with:
sku: rest.sku
outputParameters:
- type: object
mapping: $.
- type: mcp
namespace: inventory-inventory-item-mcp
port: 9090
transport: http
description: MCP adapter for eBay Inventory API — Inventory_item. One tool per consumed operation, routed inline through
this capability's consumes block.
tools:
- name: span-class-tablenote-strong-note-strong-please-note
description: Note: Please note that any eBay listing created using the Inventory
API cannot be revised or relisted using the Trading API calls.
Note:
Each listin
hints:
readOnly: false
destructive: false
idempotent: false
call: inventory-inventory-item.bulkcreateorreplaceinventoryitem
with:
Content-Type: tools.Content-Type
Content-Language: tools.Content-Language
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: this-call-retrieves-up-25
description: This call retrieves up to 25 inventory item records. The SKU value of each inventory item record to retrieve
is specified in the request payload.
Note: In addition to the authorization
head
hints:
readOnly: true
destructive: false
idempotent: false
call: inventory-inventory-item.bulkgetinventoryitem
with:
Content-Type: tools.Content-Type
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: this-call-is-used-seller
description: This call is used by the seller to update the total ship-to-home quantity of one inventory item, and/or
to update the price and/or quantity of one or more offers associated with one inventory item. Up to 25 offers associated
with an invento
hints:
readOnly: false
destructive: false
idempotent: false
call: inventory-inventory-item.bulkupdatepricequantity
with:
Content-Type: tools.Content-Type
body: tools.body
outputParameters:
- type: object
mapping: $.
- name: this-call-retrieves-all-inventory
description: This call retrieves all inventory item records defined for the seller's account. The limit
query parameter allows the seller to control how many records are returned per page, and the offset
query parameter
hints:
readOnly: true
destructive: false
idempotent: true
call: inventory-inventory-item.getinventoryitems
with:
limit: tools.limit
offset: tools.offset
outputParameters:
- type: object
mapping: $.
- name: this-call-retrieves-inventory-item
description: This call retrieves the inventory item record for a given SKU. The SKU value is passed in at the end of
the call URI. There is no request payload for this call.
The authorization header is the only
required HTTP header f
hints:
readOnly: true
destructive: false
idempotent: true
call: inventory-inventory-item.getinventoryitem
with:
sku: tools.sku
outputParameters:
- type: object
mapping: $.
- name: span-class-tablenote-strong-note-strong-please-note-2
description: Note: Please note that any eBay listing created using the Inventory
API cannot be revised or relisted using the Trading API calls.
Note:
Each listin
hints:
readOnly: false
destructive: false
idempotent: true
call: inventory-inventory-item.createorreplaceinventoryitem
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-delete
description: 'This call is used to delete an inventory item record associated with a specified SKU. A successful call
will not only delete that inventory item record, but will also have the following effects:- Delete any and all
unpublished offers '
hints:
readOnly: false
destructive: true
idempotent: true
call: inventory-inventory-item.deleteinventoryitem
with:
sku: tools.sku
outputParameters:
- type: object
mapping: $.