tray-kits

Manage product kits and component relationships in Tray stores via REST calls.

14|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/tray-tecnologia/tray-api-claude-plugin --skill tray-kits
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tray-kits
Source: https://github.com/tray-tecnologia/tray-api-claude-plugin/tree/main/skills/kits
Command: npx skills add https://github.com/tray-tecnologia/tray-api-claude-plugin --skill tray-kits

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables developers to manage product kits (combos/bundles) in Tray stores without manual API discovery, reducing mistakes when creating, listing, updating, or synchronizing bundled products and their quantities.

Core Features & Use Cases

  • List and paginate kits: Retrieve all kits with standard pagination parameters for catalog audits and synchronization.
  • Create and update kits: Programmatically create kit component relationships and update quantities for promotional combos or pack adjustments.
  • Inventory-aware bundling: Ensures kits reference existing product and kit product IDs and highlights that kit stock is derived from component availability.
  • Use case: Automate creating a promotional combo by creating the kit product, associating three component products with specified quantities, and validating inventory before publishing.

Quick Start

Create a kit by instructing the assistant to create a kit product and then call the API to add components 101 (quantity 2) and 102 (quantity 1) using the appropriate product and kit_product IDs with your access_token.

Frequently Asked Questions about tray-kits

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create product bundles and kits in Tray ecommerce stores?

To create product bundles in Tray stores, you use REST API calls with an access_token to associate existing component product IDs with a kit product ID and specify their quantities. You must first ensure both the kit product and component products already exist in the catalog.

How does kit inventory synchronization work for Tray store bundles?

Kit inventory synchronization in Tray bundles is derived directly from the availability of individual component products. The kit's stock is not managed independently but reflects the lowest available quantity among its associated component products.

Can I paginate and retrieve all existing kits from the Tray API?

Yes, you can list and retrieve all existing kits from the Tray API using standard pagination parameters. By passing limit and page query parameters in your REST calls, you can audit and synchronize bundled products efficiently.

Do I need existing product IDs to update promotional combos in Tray?

Yes, updating promotional combos requires existing product and kit product IDs to modify kit entries. You must reference valid component identifiers and specify new quantities to programmatically adjust pack relationships via the API.

What's the best way to automate promotional combo setup for Tray catalogs?

The best way to automate promotional combo setup is programmatically creating the kit product, associating multiple component products with specified quantities via REST API calls, and validating component inventory availability before publishing the bundle.

Are there limitations when managing Tray store kits via the API?

A key limitation is that kit stock is entirely dependent on component availability, meaning you cannot set standalone inventory for a kit. Additionally, all API requests require access_token query authentication and valid existing product IDs.