API Overview - Depict Documentation

Supergrid by Depict is Depict’s native Shopify product: it merchandises your existing Shopify collections without any theme changes. The Supergrid API is the REST API behind the app’s admin experience.

Base URL

The Supergrid API is served under the /api/lite prefix of the Depict portal backend:

https://<portal-host>/api/lite

Authentication

All endpoints require a bearer token issued by Depict’s Auth0 tenant:

curl https://<portal-host>/api/lite/collections \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "x-merchant-id: $MERCHANT_ID"

Most endpoints resolve the store from the authenticated user; multi-store endpoints take explicit merchant_id parameters.

What you can do with it

Collections — list, activate and configure merchandised collections, including the ordering that Depict pushes back to Shopify.
Boost & bury — manage per-collection and global boost/bury rules.
Dashboard — read the performance numbers shown on the Supergrid dashboard.
A/B testing — configure and read results of collection A/B tests.
Multi-store — connect several Shopify stores and replicate collection configuration between them.
Onboarding & Shopify integration — ingestion status, theme compatibility checks and app onboarding state.

​Base URL

​Authentication

​What you can do with it

Base URL

Authentication

What you can do with it