meet and rockDeveloper Docs

Products API

Manage products in your project — including pricing, inventory, categorization, and images. Use these endpoints to list, create, update, and delete products that are visible across your workspace.

Base URL

All URLs referenced in the documentation use the following base:

Base URL
https://api.meetandrock.com/v1/dev

Product Management

Endpoints for listing, creating, updating, and deleting products in your project. Product records include pricing, inventory, category, and image metadata.

GET/products

List products

Retrieve products for the current project with pagination and rich filtering and search support.

  • Search: Searches across product name, description, sku and category_id.
  • Pagination: Use page and limit to control page size. The response includes pagination metadata.
GEThttps://api.meetandrock.com/v1/dev/products?page=1&limit=10&search=widget&status=active&category_id=cat_123
List products

List products for the current project with pagination and filters.

curl -X GET "https://api.meetandrock.com/v1/dev/products?page=1&limit=10&search=widget&status=active&category_id=cat_123" \
  -H "Authorization: Bearer YOUR_API_KEY"
POST/products

Create product

Create a new product record with optional category and image uploads.

Required fields

  • name
  • price
  • units_in_stock

Optional fields

  • description
  • sku
  • category_id (optional)
  • status

Status values: active, inactive, discontinued.

Images: Upload multiple images using the files field. Supported formats: jpg, jpeg, png, gif, webp.

POSThttps://api.meetandrock.com/v1/dev/products
Create product

Create a new product with pricing, inventory and optional category and images.

curl -X POST "https://api.meetandrock.com/v1/dev/products" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "name=Premium Widget" \
  -F "description=High-quality widget for professional use" \
  -F "price=99.99" \
  -F "units_in_stock=100" \
  -F "sku=WID-001" \
  -F "category_id=cat_123" \
  -F "status=active" \
  -F "files=@/path/to/product-image1.jpg" \
  -F "files=@/path/to/product-image2.jpg"
PUT/products/:productId

Update product

Update an existing product. Only the provided fields will be changed. New images are appended to existing ones.

PUThttps://api.meetandrock.com/v1/dev/products/:productId
Update product

Update selected fields for an existing product.

curl -X PUT "https://api.meetandrock.com/v1/dev/products/:productId" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "name=Updated Product Name" \
  -F "price=129.99" \
  -F "units_in_stock=150" \
  -F "category_id=cat_456" \
  -F "files=@/path/to/new-image.jpg"
DELETE/products/:productId

Delete product

Permanently delete a product from the project.

DELETEhttps://api.meetandrock.com/v1/dev/products/:productId
Delete product

Delete a product by its unique identifier.

curl -X DELETE "https://api.meetandrock.com/v1/dev/products/:productId" \
  -H "Authorization: Bearer YOUR_API_KEY"

Error responses

Standard error responses for the Products API.

400 Bad Request

The request body or query parameters are invalid.

{
  "message": "Invalid request parameters"
}

401 Unauthorized

The API key is missing, expired, or invalid.

{
  "message": "Invalid or missing API key"
}

404 Not Found

The requested product does not exist or is not accessible.

{
  "message": "Product not found"
}

500 Internal Server Error

An unexpected error occurred on our side.

{
  "message": "Something went wrong"
}

Contents