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.

Serialization

API endpoints for Serialization.

POST /api/ee/serialization/export

Serialize and retrieve Metabase instance.

Outputs .tar.gz file with serialization results and an export.log file. On error outputs serialization logs directly.

You must be a superuser to do this.

PARAMS:

  • field_values Serialize cached field values.

  • data_model Serialize Metabase data model.

  • collection collections’ db ids/entity-ids to serialize.

  • dirname name of directory and archive file (default: <instance-name>-<YYYY-MM-dd_HH-mm>).

  • continue_on_error Do not break execution on errors.

  • settings Serialize Metabase settings.

  • all_collections Serialize all collections (true unless you specify collection).

  • full_stacktrace Show full stacktraces in the logs.

  • database_secrets Serialize details how to connect to each db.

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:

  • continue_on_error Do not break execution on errors.

  • full_stacktrace Show full stacktraces in the logs.

  • file .tgz with serialization data.


« Back to API index

Read docs for other versions of Metabase.

Want to improve these docs? Propose a change.