Skip to content
Jetrepo
Esc
navigateopen⌘Jpreview
On this page

Portability

Plan snapshots, artifacts, mappings, and reviewed imports.

Portability moves selected Backend model and data through a versioned portable snapshot. It is not a database backup or live synchronization system.

Portability objects

Object Purpose
Portable snapshot Versioned package of selected model, content, files, workflows, Releases, collaboration, and history
Export job Freezes selected Backend data into an artifact
Import job Validates an artifact against a target Backend
Migration plan Reviewed ordered diff with risks, blockers, warnings, and identity mappings
Identity map Rewrites source identities to target identities
User mapping Maps source users to existing target users without creating placeholders

Use Settings → Import / Export and its Export, Import, Migration plan, and Jobs tabs. Reading jobs requires backend.read and portability.read. Starting an export uses portability.export; validating an existing-Backend import uses portability.import; applying a plan uses portability.apply; deleting artifact bytes uses portability.delete. Each Backend-scoped action also requires matching backend.read.

Secrets are excluded. Re-enter API keys, webhook secrets, OAuth credentials, and other secrets after import.

Artifacts are capped at 1,000,000,000 bytes and migration plans at 10,000 operations. An artifact records a seven-day expiry; automatic byte cleanup at that time is not guaranteed.

Was this page helpful?