Skip to main content

Import & Export

Transfer datasets and organizations between Registry instances.

Importing Datasets​

Import datasets from another Registry instance via API:

POST /sys/import-dataset
{
"sourceUrl": "https://source-registry.com",
"orgSlug": "source-org",
"dsSlug": "source-dataset",
"targetOrgSlug": "target-org",
"targetDsSlug": "target-dataset",
"token": "auth-token"
}

Parameters​

ParameterDescription
sourceUrlBase URL of the source Registry instance
orgSlugOrganization slug on the source instance
dsSlugDataset slug on the source instance
targetOrgSlugOrganization slug on the target instance
targetDsSlugDataset slug on the target instance
tokenAuthentication token for the source instance

Importing Organizations​

Import entire organizations with all their datasets:

POST /sys/import-organization
{
"sourceUrl": "https://source-registry.com",
"orgSlug": "source-org",
"targetOrgSlug": "target-org",
"token": "auth-token"
}

Parameters​

ParameterDescription
sourceUrlBase URL of the source Registry instance
orgSlugOrganization slug on the source instance
targetOrgSlugOrganization slug on the target instance
tokenAuthentication token for the source instance

Authentication​

Both import endpoints require:

  1. Admin privileges on the target Registry instance
  2. Valid authentication token from the source Registry instance

Use Cases​

  • Data migration: Move datasets between on-premise and cloud instances
  • Backup and recovery: Clone datasets to a backup Registry
  • Collaboration: Share datasets between organizations running their own Registry instances