Skip to main content
Products are the core resources in Lightyshare that represent items available for rental. Each product can be a single item or a bundle of multiple items.

Product Types

Individual Products (productType: 0)

Single items that can be rented individually, such as cameras, lenses, or lighting equipment.

Bundles (productType: 1)

Collections of multiple products that are rented together as a package.

Stock Management

Unit Stock (stock_type: 0)

Products with individual unit tracking. Each unit has a unique SKU and can be tracked separately. Required fields:
  • sku: Unique identifier for the product unit
  • quantity: Number of units available

Without Unit Management (stock_type: 1)

Products without individual unit tracking. Only the total quantity is managed.

Creating a Product

Basic Product Creation

Product with Equipment

Updating a Product

Partial Update

Product Fields

Required Fields

Optional Fields

Equipment Items

Each equipment item requires:

Image Requirements

Each image requires:
  • Maximum 5 images per product
  • Images must be accessible URLs
  • Recommended format: WEBP, JPG, PNG
  • Recommended size: 1200x800 pixels

Response Examples

Successful Creation

Successful Update

Error Handling

Validation Errors

Common Error Codes

  • REQUIRED: Missing required field
  • INVALID_FORMAT: Invalid data format
  • MIN_VALUE: Value below minimum
  • MAX_LENGTH: String exceeds maximum length