Skip to main content

​
Base URL

Use the production Gen 2 API front door unless Tailoredd gives you a tenant-specific endpoint. Staging smoke tests use the direct apiV2 Cloud Functions URL.

​
Authentication

All requests require X-Merchant-Id. Additional auth depends on the call context: See Authentication for full details.

​
Response format

Admin and write endpoints return a structured JSON envelope:
On error:
Public read endpoints can return resource-shaped payloads directly, for example GET /products/{productId}/reviews returns top-level reviews, totalReviews, and pagination fields. See Error codes for the full list.

​
Rate limits

Rate-limited responses return 429 Too Many Requests with a Retry-After header.

​
Pagination

Review endpoints use page-number pagination (page=1&limit=20). Q&A endpoints use cursor-based pagination (startAfter={id}).

​
Plan-gated features

Some features return 403 PLAN_UPGRADE_REQUIRED on lower-tier plans: See Plans for full comparison.