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.

Serialization

API endpoints for Serialization.

POST /api/ee/serialization/export

Serialize and retrieve Metabase instance.

Parameters:

  • dirname: str, name of directory and archive file (default: <instance-name>-<YYYY-MM-dd_HH-mm>)
  • all_collections: bool, serialize all collections (default: true, unless you specify collection)
  • collection: array of int, db id of a collection to serialize
  • settings: bool, if Metabase settings should be serialized (default: true)
  • data_model: bool, if Metabase data model should be serialized (default: true)
  • field_values: bool, if cached field values should be serialized (default: false)
  • database_secrets: bool, if details how to connect to each db should be serialized (default: false)

Outputs .tar.gz file with serialization results and an export.log file. On error just returns serialization logs.

You must be a superuser to do this.

PARAMS:

  • all_collections nullable value must be a valid boolean string (‘true’ or ‘false’).

  • collection nullable vector of value must be an integer greater than zero.

  • settings nullable value must be a valid boolean string (‘true’ or ‘false’).

  • data_model nullable value must be a valid boolean string (‘true’ or ‘false’).

  • field_values nullable value must be a valid boolean string (‘true’ or ‘false’).

  • database_secrets nullable value must be a valid boolean string (‘true’ or ‘false’).

  • dirname

POST /api/ee/serialization/import

Deserialize Metabase instance from an archive generated by /export.

Parameters:

  • file: archive encoded as multipart/form-data (required).

Returns logs of deserialization.

You must be a superuser to do this.

PARAMS:

  • raw-params

« Back to API index

Read docs for other versions of Metabase.

Thanks for your feedback!

See something that needs fixing? Propose a change.