v4
Data Apps
Serve an embedded data-app HTML artifact with the signed token injected
Serve the stripped data-app HTML with the embed token injected.
This is the top-level navigation URL that customers drop into an iframe on their own site. The token lives in the URL query string (?t=...); there is no separate header. Auth is handled by :class:DataAppEmbedTokenFromQuery which verifies the signed token before the handler body runs. On success, the HTML arrives with:
- Cache-Control: private, no-store (tokens are per-request)
- Referrer-Policy: no-referrer (prevents URL leak via Referer)
- Content-Security-Policy: frame-ancestors <hosts> (click-jack protection)
The browser's definite-runtime reads window.__DEFINITE_EMBED from the injected script tag and sends the token as Authorization: Bearer ... on every /v4/data-apps/query call.
get/v4/data-apps/embed
Request
- Base URLhttps://api.definite.app (the document declares no server; this is the origin it was published from)
- Authnone declared
- TypeScriptA function with typed inputs. Its response is checked against the schema.
Response
Successful Response
unknown required
Changes
No recorded changes to this operation across all 2 revisions of this API.