naftiko: 1.0.0-alpha2 info: label: Walmart Item Management — Items description: 'Walmart Item Management — Items. 10 operations. Lead operation: Walmart Bulk Item Setup (multiple). Self-contained Naftiko capability covering one Walmart business surface.' tags: - Walmart - Items created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: WALMART_API_KEY: WALMART_API_KEY capability: consumes: - type: http namespace: marketplace-items-items baseUri: https://marketplace.walmartapis.com description: Walmart Item Management — Items business capability. Self-contained, no shared references. resources: - name: v3-feeds path: /v3/feeds operations: - name: itembulkuploads method: POST description: Walmart Bulk Item Setup (multiple) outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: feedType in: query type: string description: The feed Type required: true - name: WM_SEC.ACCESS_TOKEN in: header type: string description: The access token retrieved in the Token API call required: true - name: WM_CONSUMER.CHANNEL.TYPE in: header type: string description: A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding - name: WM_QOS.CORRELATION_ID in: header type: string description: A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID required: true - name: WM_SVC.NAME in: header type: string description: Walmart Service Name required: true - name: body in: body type: object description: Request body (JSON). required: true - name: v3-items path: /v3/items operations: - name: getallitems method: GET description: Walmart All Items outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: nextCursor in: query type: string description: Used for pagination when more than 200 items are retrieved.nextCursor value received in response will be same for all subsequent page requests. - name: sku in: query type: string description: An arbitrary alphanumeric unique ID, specified by the seller, which identifies each item. This will be used by the seller in the XSD file to refer to each item. - name: offset in: query type: string description: The object response to start with, where 0 is the first entity that can be requested. It can only be used when includeDetails is set to true. - name: limit in: query type: string description: The number of entities to be returned. It cannot be more than 50 entities. Use it only when the includeDetails is set to true. - name: lifecycleStatus in: query type: string description: The lifecycle status of an item describes where the item listing is in the overall lifecycle. Examples of allowed values are ACTIVE , ARCHIVED, RETIRED. - name: publishedStatus in: query type: string description: The published status of an item describes where the item is in the submission process. Examples of allowed values are PUBLISHED, UNPUBLISHED. - name: variantGroupId in: query type: string description: Variant Id to retrieve all items with the same variant id - name: condition in: query type: string description: The value of product condition, (e.g. Restored). - name: WM_SEC.ACCESS_TOKEN in: header type: string description: The access token retrieved in the Token API call required: true - name: WM_CONSUMER.CHANNEL.TYPE in: header type: string description: A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding - name: WM_QOS.CORRELATION_ID in: header type: string description: A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID required: true - name: WM_SVC.NAME in: header type: string description: Walmart Service Name required: true - name: v3-items-associations path: /v3/items/associations operations: - name: getitemassociations method: POST description: Walmart Get Item Associations outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: WM_SEC.ACCESS_TOKEN in: header type: string description: The access token retrieved in the Token API call required: true - name: WM_CONSUMER.CHANNEL.TYPE in: header type: string description: A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding - name: WM_QOS.CORRELATION_ID in: header type: string description: A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID required: true - name: WM_SVC.NAME in: header type: string description: Walmart Service Name required: true - name: body in: body type: object description: Request body (JSON). required: true - name: v3-items-catalog-search path: /v3/items/catalog/search operations: - name: getcatalogsearch method: POST description: Walmart Catalog Search outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: page in: query type: integer description: number of page - name: limit in: query type: integer description: number of items - name: nextCursor in: query type: string description: nextCursor - name: WM_SEC.ACCESS_TOKEN in: header type: string description: The access token retrieved in the Token API call required: true - name: WM_CONSUMER.CHANNEL.TYPE in: header type: string description: A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding - name: WM_QOS.CORRELATION_ID in: header type: string description: A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID required: true - name: WM_SVC.NAME in: header type: string description: Walmart Service Name required: true - name: body in: body type: object description: Request body (JSON). required: true - name: v3-items-count path: /v3/items/count operations: - name: getcountbystatus method: GET description: Walmart Get Items Count by Status outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: status in: query type: string description: Status of Item - name: WM_SEC.ACCESS_TOKEN in: header type: string description: The access token retrieved in the Token API call required: true - name: WM_CONSUMER.CHANNEL.TYPE in: header type: string description: A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding - name: WM_QOS.CORRELATION_ID in: header type: string description: A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID required: true - name: WM_SVC.NAME in: header type: string description: Walmart Service Name required: true - name: v3-items-groups-count path: /v3/items/groups/count operations: - name: getvariantcount method: GET description: Walmart Get Item Count by Groups outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: variantGroupId in: query type: string description: Variant Id to retrieve - name: WM_SEC.ACCESS_TOKEN in: header type: string description: The access token retrieved in the Token API call required: true - name: WM_CONSUMER.CHANNEL.TYPE in: header type: string description: A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding - name: WM_QOS.CORRELATION_ID in: header type: string description: A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID required: true - name: WM_SVC.NAME in: header type: string description: Walmart Service Name required: true - name: v3-items-taxonomy path: /v3/items/taxonomy operations: - name: gettaxonomyresponse method: GET description: Walmart Taxonomy outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: WM_SEC.ACCESS_TOKEN in: header type: string description: The access token retrieved in the Token API call required: true - name: WM_CONSUMER.CHANNEL.TYPE in: header type: string description: A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding - name: WM_QOS.CORRELATION_ID in: header type: string description: A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID required: true - name: WM_SVC.NAME in: header type: string description: Walmart Service Name required: true - name: v3-items-walmart-search path: /v3/items/walmart/search operations: - name: getsearchresult method: GET description: Walmart Item Search outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: query in: query type: string description: Specifies a keyword search as a String. - name: upc in: query type: string description: Specifies a Universal Product Code (UPC) search. UPC must be 12 digits. - name: gtin in: query type: string description: Specifies a Global Trade Item Number (GTIN) search. GTIN must be 14 digits. - name: WM_SEC.ACCESS_TOKEN in: header type: string description: The access token retrieved in the Token API call required: true - name: WM_CONSUMER.CHANNEL.TYPE in: header type: string description: A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding - name: WM_QOS.CORRELATION_ID in: header type: string description: A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID required: true - name: WM_SVC.NAME in: header type: string description: Walmart Service Name required: true - name: v3-items-SKU path: /v3/items/{SKU} operations: - name: retireanitem method: DELETE description: Walmart Retire an Item outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: SKU in: path type: string description: An arbitrary alphanumeric unique ID, specified by the seller, which identifies each item. This will be used by the seller in the XSD file to refer to each item. required: true - name: WM_SEC.ACCESS_TOKEN in: header type: string description: The access token retrieved in the Token API call required: true - name: WM_CONSUMER.CHANNEL.TYPE in: header type: string description: A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding - name: WM_QOS.CORRELATION_ID in: header type: string description: A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID required: true - name: WM_SVC.NAME in: header type: string description: Walmart Service Name required: true - name: v3-items-id path: /v3/items/{id} operations: - name: getanitem method: GET description: Walmart an Item outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: id in: path type: string description: Represents the seller-specified unique ID for each item. Takes SKU code by default. If you require more specific item codes, such as GTIN, UPC, ISBN, EAN, or IT required: true - name: productIdType in: query type: string description: Item code type specifier allows to filter by specific code type, (e.g. GTIN). required: true - name: condition in: query type: string description: The value of product condition, (e.g. Restored). - name: WM_SEC.ACCESS_TOKEN in: header type: string description: The access token retrieved in the Token API call required: true - name: WM_CONSUMER.CHANNEL.TYPE in: header type: string description: A unique ID to track the consumer request by channel. Use the Consumer Channel Type received during onboarding - name: WM_QOS.CORRELATION_ID in: header type: string description: A unique ID which identifies each API call and used to track and debug issues; use a random generated GUID for this ID required: true - name: WM_SVC.NAME in: header type: string description: Walmart Service Name required: true exposes: - type: rest namespace: marketplace-items-items-rest port: 8080 description: REST adapter for Walmart Item Management — Items. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/v3/feeds name: v3-feeds description: REST surface for v3-feeds. operations: - method: POST name: itembulkuploads description: Walmart Bulk Item Setup (multiple) call: marketplace-items-items.itembulkuploads with: feedType: rest.feedType WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID WM_SVC.NAME: rest.WM_SVC.NAME body: rest.body outputParameters: - type: object mapping: $. - path: /v1/v3/items name: v3-items description: REST surface for v3-items. operations: - method: GET name: getallitems description: Walmart All Items call: marketplace-items-items.getallitems with: nextCursor: rest.nextCursor sku: rest.sku offset: rest.offset limit: rest.limit lifecycleStatus: rest.lifecycleStatus publishedStatus: rest.publishedStatus variantGroupId: rest.variantGroupId condition: rest.condition WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID WM_SVC.NAME: rest.WM_SVC.NAME outputParameters: - type: object mapping: $. - path: /v1/v3/items/associations name: v3-items-associations description: REST surface for v3-items-associations. operations: - method: POST name: getitemassociations description: Walmart Get Item Associations call: marketplace-items-items.getitemassociations with: WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID WM_SVC.NAME: rest.WM_SVC.NAME body: rest.body outputParameters: - type: object mapping: $. - path: /v1/v3/items/catalog/search name: v3-items-catalog-search description: REST surface for v3-items-catalog-search. operations: - method: POST name: getcatalogsearch description: Walmart Catalog Search call: marketplace-items-items.getcatalogsearch with: page: rest.page limit: rest.limit nextCursor: rest.nextCursor WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID WM_SVC.NAME: rest.WM_SVC.NAME body: rest.body outputParameters: - type: object mapping: $. - path: /v1/v3/items/count name: v3-items-count description: REST surface for v3-items-count. operations: - method: GET name: getcountbystatus description: Walmart Get Items Count by Status call: marketplace-items-items.getcountbystatus with: status: rest.status WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID WM_SVC.NAME: rest.WM_SVC.NAME outputParameters: - type: object mapping: $. - path: /v1/v3/items/groups/count name: v3-items-groups-count description: REST surface for v3-items-groups-count. operations: - method: GET name: getvariantcount description: Walmart Get Item Count by Groups call: marketplace-items-items.getvariantcount with: variantGroupId: rest.variantGroupId WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID WM_SVC.NAME: rest.WM_SVC.NAME outputParameters: - type: object mapping: $. - path: /v1/v3/items/taxonomy name: v3-items-taxonomy description: REST surface for v3-items-taxonomy. operations: - method: GET name: gettaxonomyresponse description: Walmart Taxonomy call: marketplace-items-items.gettaxonomyresponse with: WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID WM_SVC.NAME: rest.WM_SVC.NAME outputParameters: - type: object mapping: $. - path: /v1/v3/items/walmart/search name: v3-items-walmart-search description: REST surface for v3-items-walmart-search. operations: - method: GET name: getsearchresult description: Walmart Item Search call: marketplace-items-items.getsearchresult with: query: rest.query upc: rest.upc gtin: rest.gtin WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID WM_SVC.NAME: rest.WM_SVC.NAME outputParameters: - type: object mapping: $. - path: /v1/v3/items/{sku} name: v3-items-sku description: REST surface for v3-items-SKU. operations: - method: DELETE name: retireanitem description: Walmart Retire an Item call: marketplace-items-items.retireanitem with: SKU: rest.SKU WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID WM_SVC.NAME: rest.WM_SVC.NAME outputParameters: - type: object mapping: $. - path: /v1/v3/items/{id} name: v3-items-id description: REST surface for v3-items-id. operations: - method: GET name: getanitem description: Walmart an Item call: marketplace-items-items.getanitem with: id: rest.id productIdType: rest.productIdType condition: rest.condition WM_SEC.ACCESS_TOKEN: rest.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: rest.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: rest.WM_QOS.CORRELATION_ID WM_SVC.NAME: rest.WM_SVC.NAME outputParameters: - type: object mapping: $. - type: mcp namespace: marketplace-items-items-mcp port: 9090 transport: http description: MCP adapter for Walmart Item Management — Items. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: walmart-bulk-item-setup-multiple description: Walmart Bulk Item Setup (multiple) hints: readOnly: false destructive: false idempotent: false call: marketplace-items-items.itembulkuploads with: feedType: tools.feedType WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID WM_SVC.NAME: tools.WM_SVC.NAME body: tools.body outputParameters: - type: object mapping: $. - name: walmart-all-items description: Walmart All Items hints: readOnly: true destructive: false idempotent: true call: marketplace-items-items.getallitems with: nextCursor: tools.nextCursor sku: tools.sku offset: tools.offset limit: tools.limit lifecycleStatus: tools.lifecycleStatus publishedStatus: tools.publishedStatus variantGroupId: tools.variantGroupId condition: tools.condition WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID WM_SVC.NAME: tools.WM_SVC.NAME outputParameters: - type: object mapping: $. - name: walmart-get-item-associations description: Walmart Get Item Associations hints: readOnly: true destructive: false idempotent: false call: marketplace-items-items.getitemassociations with: WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID WM_SVC.NAME: tools.WM_SVC.NAME body: tools.body outputParameters: - type: object mapping: $. - name: walmart-catalog-search description: Walmart Catalog Search hints: readOnly: true destructive: false idempotent: false call: marketplace-items-items.getcatalogsearch with: page: tools.page limit: tools.limit nextCursor: tools.nextCursor WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID WM_SVC.NAME: tools.WM_SVC.NAME body: tools.body outputParameters: - type: object mapping: $. - name: walmart-get-items-count-status description: Walmart Get Items Count by Status hints: readOnly: true destructive: false idempotent: true call: marketplace-items-items.getcountbystatus with: status: tools.status WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID WM_SVC.NAME: tools.WM_SVC.NAME outputParameters: - type: object mapping: $. - name: walmart-get-item-count-groups description: Walmart Get Item Count by Groups hints: readOnly: true destructive: false idempotent: true call: marketplace-items-items.getvariantcount with: variantGroupId: tools.variantGroupId WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID WM_SVC.NAME: tools.WM_SVC.NAME outputParameters: - type: object mapping: $. - name: walmart-taxonomy description: Walmart Taxonomy hints: readOnly: true destructive: false idempotent: true call: marketplace-items-items.gettaxonomyresponse with: WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID WM_SVC.NAME: tools.WM_SVC.NAME outputParameters: - type: object mapping: $. - name: walmart-item-search description: Walmart Item Search hints: readOnly: true destructive: false idempotent: true call: marketplace-items-items.getsearchresult with: query: tools.query upc: tools.upc gtin: tools.gtin WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID WM_SVC.NAME: tools.WM_SVC.NAME outputParameters: - type: object mapping: $. - name: walmart-retire-item description: Walmart Retire an Item hints: readOnly: false destructive: true idempotent: true call: marketplace-items-items.retireanitem with: SKU: tools.SKU WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID WM_SVC.NAME: tools.WM_SVC.NAME outputParameters: - type: object mapping: $. - name: walmart-item description: Walmart an Item hints: readOnly: true destructive: false idempotent: true call: marketplace-items-items.getanitem with: id: tools.id productIdType: tools.productIdType condition: tools.condition WM_SEC.ACCESS_TOKEN: tools.WM_SEC.ACCESS_TOKEN WM_CONSUMER.CHANNEL.TYPE: tools.WM_CONSUMER.CHANNEL.TYPE WM_QOS.CORRELATION_ID: tools.WM_QOS.CORRELATION_ID WM_SVC.NAME: tools.WM_SVC.NAME outputParameters: - type: object mapping: $.