Embed SDK

The Embed SDK renders a Queringo dashboard inside your own page using a short-lived signed token. It is an enterprise capability.

Adding an embed

Load the SDK and call embed with a container, a dashboard id, and a token:

The SDK is served from the CDN (cdn.queringo.com) and, as a fallback, from the app origin at /sdk.js (same host you sign in on). Pick whichever your content security policy allows.

<div id="qg-dashboard"></div>
<script src="https://cdn.queringo.com/sdk.js"></script>
<!-- or, served from the app origin:
<script src="https://app.queringo.com/sdk.js"></script>
-->
<script>
  Queringo.embed({
    container: "#qg-dashboard",         // CSS selector or HTMLElement
    dashboardId: "your-dashboard-id",   // returned by POST /v1/embed-tokens
    token: "short-lived-signed-token",
    theme: "auto",                      // "auto" | "light" | "dark"
    minHeight: 600,                     // px floor; the iframe auto-resizes
  });
</script>

The iframe loads /embed/{dashboardId}?token=... on the app origin and resizes itself to fit the dashboard via postMessage, so you do not need to set a fixed height.

How it stays secure

• The dashboard renders in a sandboxed iframe that blocks top-level navigation and form submission.
• Access is granted by a short-lived signed token your backend mints, so you control who can view the embed and for how long.

What's next

Automate from the terminal with the CLI.