API reference

Public API surface

The route groups below cover the public integration surface for apps, storefront automation, marketplace discovery, analytics, and lifecycle operations.

Start with
OAuth + webhooks
Then wire
Storefront and marketplace routes
Finish with
Analytics and ops tooling

Authentication

Install apps with OAuth, scoped tokens, refresh rotation, and explicit revoke flows.

GET /api/commerce/oauth/authorize
POST /api/commerce/oauth/token
POST /api/commerce/oauth/revoke

Marketplace

Discover listings, installs, reviews, rankings, and moderation surfaces.

GET /api/commerce/marketplace
GET /api/commerce/marketplace/listings
GET /api/commerce/marketplace/listings/:id

Storefront

Theme files, embeds, sections, versioning, and publish orchestration for seller storefronts.

GET /api/storefront/assets
POST /api/storefront/publish
POST /api/storefront/rollback

Webhooks

Subscribe to order, payment, delivery, customer, and lifecycle events with retries.

POST /api/webhooks
GET /api/webhooks
POST /api/webhooks/:id/test

Analytics

Funnels, cohorts, experiments, attribution, exports, and divergence detection.

GET /api/analytics/summary
GET /api/analytics/cohorts
GET /api/analytics/exports

Developer operations

Partner onboarding, app activity, provider diagnostics, and AI generation workflows.

POST /api/developer/partner-onboarding
GET /api/developer/apps/:id/activity
GET /api/developer/ai-summary

What to wire first

For most integrations, start with OAuth, then add webhooks, then use storefront or marketplace endpoints for the actual automation layer.