These are the docs for the Metabase master branch. Some features documented here may not yet be available in the latest release. Check out the docs for the latest version, Metabase v0.49.

Preview embed

Endpoints for previewing how Cards and Dashboards will look when embedding them. These endpoints are basically identical in functionality to the ones in /api/embed, but:

  1. Require admin access
  2. Ignore the values of :enabled_embedding for Cards/Dashboards
  3. Ignore the :embed_params whitelist for Card/Dashboards, instead using a field called :_embedding_params in the JWT token itself.

Refer to the documentation for those endpoints for further details.

GET /api/preview-embed/card/:token

Fetch a Card you’re considering embedding by passing a JWT token.

PARAMS:

  • token value must be a non-blank string.

GET /api/preview-embed/card/:token/query

Fetch the query results for a Card you’re considering embedding by passing a JWT token.

PARAMS:

  • token value must be a non-blank string.

  • &

  • query-params

GET /api/preview-embed/dashboard/:token

Fetch a Dashboard you’re considering embedding by passing a JWT token. .

PARAMS:

  • token value must be a non-blank string.

GET /api/preview-embed/dashboard/:token/dashcard/:dashcard-id/card/:card-id

Fetch the results of running a Card belonging to a Dashboard you’re considering embedding with JWT token.

PARAMS:

  • token value must be a non-blank string.

  • dashcard-id value must be an integer greater than zero.

  • card-id value must be an integer greater than zero.

  • &

  • query-params

GET /api/preview-embed/pivot/card/:token/query

Fetch the query results for a Card you’re considering embedding by passing a JWT token.

PARAMS:

  • token value must be a non-blank string.

  • &

  • query-params

GET /api/preview-embed/pivot/dashboard/:token/dashcard/:dashcard-id/card/:card-id

Fetch the results of running a Card belonging to a Dashboard you’re considering embedding with JWT token.

PARAMS:

  • token value must be a non-blank string.

  • dashcard-id value must be an integer greater than zero.

  • card-id value must be an integer greater than zero.

  • &

  • query-params


« Back to API index

Read docs for other versions of Metabase.

Thanks for your feedback!

See something that needs fixing? Propose a change.