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.51.

Public

Metabase API endpoints for viewing publicly-accessible Cards and Dashboards.

GET /api/public/action/:uuid

Fetch a publicly-accessible Action. Does not require auth credentials. Public sharing must be enabled.

PARAMS:

  • uuid value must be a valid UUID.

GET /api/public/card/:uuid

Fetch a publicly-accessible Card an return query results as well as :card information. Does not require auth credentials. Public sharing must be enabled.

PARAMS:

  • uuid value must be a valid UUID.

GET /api/public/card/:uuid/field/:field-id/remapping/:remapped-id

Fetch remapped Field values. This is the same as GET /api/field/:id/remapping/:remapped-id, but for use with public Cards.

PARAMS:

  • uuid value must be a valid UUID.

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

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

  • value value must be a non-blank string.

GET /api/public/card/:uuid/field/:field-id/search/:search-field-id

Search for values of a Field that is referenced by a public Card.

PARAMS:

  • uuid value must be a valid UUID.

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

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

  • value value must be a non-blank string.

  • limit nullable value must be an integer greater than zero.

GET /api/public/card/:uuid/field/:field-id/values

Fetch FieldValues for a Field that is referenced by a public Card.

PARAMS:

  • uuid value must be a valid UUID.

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

GET /api/public/card/:uuid/params/:param-key/search/:query

Fetch values for a parameter on a public card containing query.

PARAMS:

  • uuid value must be a valid UUID.

  • param-key value must be a non-blank string.

  • query value must be a non-blank string.

GET /api/public/card/:uuid/params/:param-key/values

Fetch values for a parameter on a public card.

PARAMS:

  • uuid value must be a valid UUID.

  • param-key value must be a non-blank string.

GET /api/public/card/:uuid/query

Fetch a publicly-accessible Card an return query results as well as :card information. Does not require auth credentials. Public sharing must be enabled.

PARAMS:

  • uuid value must be a valid UUID.

  • parameters nullable value must be a valid JSON string.

GET /api/public/card/:uuid/query/:export-format

Fetch a publicly-accessible Card and return query results in the specified format. Does not require auth credentials. Public sharing must be enabled.

PARAMS:

  • uuid value must be a valid UUID.

  • export-format enum of csv, api, xlsx, json.

  • parameters nullable value must be a valid JSON string.

  • format_rows nullable boolean.

GET /api/public/dashboard/:uuid

Fetch a publicly-accessible Dashboard. Does not require auth credentials. Public sharing must be enabled.

PARAMS:

  • uuid value must be a valid UUID.

GET /api/public/dashboard/:uuid/dashcard/:dashcard-id/card/:card-id

Fetch the results for a Card in a publicly-accessible Dashboard. Does not require auth credentials. Public sharing must be enabled.

PARAMS:

  • uuid value must be a valid UUID.

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

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

  • parameters nullable value must be a valid JSON string.

GET /api/public/dashboard/:uuid/dashcard/:dashcard-id/execute

Fetches the values for filling in execution parameters. Pass PK parameters and values to select.

PARAMS:

  • uuid value must be a valid UUID.

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

  • parameters value must be a valid JSON string.

GET /api/public/dashboard/:uuid/field/:field-id/remapping/:remapped-id

Fetch remapped Field values. This is the same as GET /api/field/:id/remapping/:remapped-id, but for use with public Dashboards.

PARAMS:

  • uuid value must be a valid UUID.

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

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

  • value value must be a non-blank string.

GET /api/public/dashboard/:uuid/field/:field-id/search/:search-field-id

Search for values of a Field that is referenced by a Card in a public Dashboard.

PARAMS:

  • uuid value must be a valid UUID.

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

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

  • value value must be a non-blank string.

  • limit nullable value must be an integer greater than zero.

GET /api/public/dashboard/:uuid/field/:field-id/values

Fetch FieldValues for a Field that is referenced by a Card in a public Dashboard.

PARAMS:

  • uuid value must be a valid UUID.

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

GET /api/public/dashboard/:uuid/params/:param-key/search/:query

Fetch filter values for dashboard parameter param-key, containing specified query.

PARAMS:

  • uuid value must be a valid UUID.

  • param-key value must be a non-blank string.

  • query value must be a non-blank string.

  • constraint-param-key->value

GET /api/public/dashboard/:uuid/params/:param-key/values

Fetch filter values for dashboard parameter param-key.

PARAMS:

  • uuid value must be a valid UUID.

  • param-key value must be a non-blank string.

  • constraint-param-key->value

GET /api/public/oembed

oEmbed endpoint used to retreive embed code and metadata for a (public) Metabase URL.

PARAMS:

  • url value must be a non-blank string.

  • format nullable enum of json.

  • maxheight nullable value must be a valid integer.

  • maxwidth nullable value must be a valid integer.

GET /api/public/pivot/card/:uuid/query

Fetch a publicly-accessible Card an return query results as well as :card information. Does not require auth credentials. Public sharing must be enabled.

PARAMS:

  • uuid value must be a valid UUID.

  • parameters nullable value must be a valid JSON string.

GET /api/public/pivot/dashboard/:uuid/dashcard/:dashcard-id/card/:card-id

Fetch the results for a Card in a publicly-accessible Dashboard. Does not require auth credentials. Public sharing must be enabled.

PARAMS:

  • uuid value must be a valid UUID.

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

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

  • parameters nullable value must be a valid JSON string.

POST /api/public/action/:uuid/execute

Execute the Action.

parameters should be the mapped dashboard parameters with values.

PARAMS:

  • uuid value must be a valid UUID.

  • parameters nullable map from to .

  • _body

POST /api/public/dashboard/:uuid/dashcard/:dashcard-id/card/:card-id/:export-format

Fetch the results of running a publicly-accessible Card belonging to a Dashboard and return the data in one of the export formats. Does not require auth credentials. Public sharing must be enabled.

PARAMS:

  • uuid value must be a valid UUID.

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

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

  • parameters nullable value must be a valid JSON string.

  • export-format enum of csv, api, xlsx, json.

POST /api/public/dashboard/:uuid/dashcard/:dashcard-id/execute

Execute the associated Action in the context of a Dashboard and DashboardCard that includes it.

parameters should be the mapped dashboard parameters with values.

PARAMS:

  • uuid value must be a valid UUID.

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

  • parameters nullable map from to .

  • _body


« Back to API index

Read docs for other versions of Metabase.

Want to improve these docs? Propose a change.