Reliefs Docs
Management APIProducts

Generate a 3D viewer iframe URL

Generates a short-lived URL (1h) for embedding the product's 3D model viewer in an `<iframe>`. The URL serves an HTML page with the viewer pre-configured — the raw GLB file URL is never exposed to the management client. This is an alternative to the SDK for backends with no JS runtime of their own (e.g. a CMS or server-rendered page) — frontends that can run JS should use the SDK instead. Requires a management API key (`mk_`).

POST
/api/v1/management/restaurants/{restaurantId}/products/{productId}/embed-token

Authorization

ManagementApiKey
X-Api-Key<token>

Management API key — starts with mk_. Generate one from your dashboard.

In: header

Path Parameters

restaurantId*string

Restaurant ID

Formatuuid
productId*string

Product ID

Formatuuid

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/api/v1/management/restaurants/497f6eca-6276-4993-bfeb-53cbbbba6f08/products/497f6eca-6276-4993-bfeb-53cbbbba6f08/embed-token"
{  "success": true,  "data": {    "iframeUrl": "http://example.com",    "expiresAt": 0  }}

Generate an App Clip scan link

Generates a one-shot capture package for the iOS App Clip scan flow. Returns a presigned upload URL, encrypted payload, and ready-to-use App Clip invocation URL. Valid for 1 hour. Requires a management API key (`mk_`).

List restaurant products

Returns resolved products for a restaurant. For franchise organisations, franchise catalogue products are merged with restaurant-specific products (overrides applied). Results are sorted by `createdAt` ascending. Requires a management API key (`mk_`).